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Overview of Fast Alpha/Font Manager 

The Fast Alpha/Font Manager is two libraries. The fast alpha display library 
provides high-performance alpha capabilites with bit-mapped displays and 
graphics windows. The font manager library provides a high-performance, low- 
level textual interface to bit-mapped displays and graphics windows. 



History of FA/FM 

The Fast Alpha/Font Manager came from Windows/9000 as a way to write to 
windows quickly and to merge alpha text (as opposed to graphics text) and 
Starbase graphics. After the FA/FM libraries were in place, it became desirable to 
expand them to work with bit mapped displays. This was done, and the libraries 
remained fairly constant until the Series 800 was developed. Since the Series 800 
does not use Windows/9000, FA/FM has been taken out of the Windows/9000 
package and packaged with Starbase since FA/FM uses many of the parts of 
Starbase — drivers, color maps, etc. 

There was no functionality change in FA/FM due to the Starbase repackaging. 



Overview of Fast Alpha/Font Manager 1-1 



Note Starbase graphics was not fully integrated into the initial release 

of XI 1. This initial release of XI 1 is designated by Hewlett- 
Packard as: 

XI 1 revision A.OO. dd 

The '00' indicates that this is the first release. The dd denotes 
two decimal digits used internally by Hewlett-Packard; these can 
be ignored. The release of XU which supports Starbase graphics 
in an XI 1 window is designated as: 

XI 1 revision A.Ol. dd 

In this document, when XI 1 is referenced, it refers to the 
release which supports Starbase in an XI 1 window (XI 1 revision 
A.Ol. dd). When the initial release is discussed, it is referred to 
specifically as XI 1 revision A.OO. dd. 

FA/FM has undergone changes to work in the XI 1 environment. What has 
changed is: 

■ FA/FM uses font files in XI 1 Server Natural Format (SNF). Fonts in the 
old Windows/9000 format can no longer be used. All Windows/9000 font 
files are now shipped in SNF as well as the original Windows/9000 format. 

■ XU fonts can now be used with the FA/FM libraries. This includes MIT 
Xll 16 bit font files. An additional entry point, fin_sixteen_bit, has 
been added to the FM library to accompany such functionality. 

FA/FM works on Series 300/800 with Xll revision A.Ol.dd, Windows/9000, and 
raw bit mapped displays. 

Outline 

Chapter 1: Overview 

Chapter 2: The Fast Alpha Library 

This chapter describes the use of the fast alpha library. The fast alpha library 
allows you to write alpha text to the display. 
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Chapter 3: The Font Manager Library 

This chapter describes the use of the font manager. In addition to writing to the 
display, the font manager allows you to select alternate fonts, place the characters 
exactly on the display, and to alter the display. 

Chapter 4: Compiling, Linking and File Sets 

This chapter describes the various libraries needed for FA/FM and the order in 
which they must be linked with the program. 

Reference: The Reference Pages for FA/FM 

The reference section contains an alphabetic listing and discussion of all the 
functions in FA/FM. These pages can also be found on-line, using the man 
command. 

Where to Go for Further Information 

The information contained in this manual refers occasionally to Starbase, Xlib, 
and Windows/9000. For further information about these subjects, refer to the 
associated manuals: 

■ Starbase Graphics Techniques, Vols. 1 and 2 

■ Windows/9000 Documentation 
m HP-UX Reference 

■ Starbase Programming with Xll 

Overview of FA/FM Routines 

Fast Alpha Routines 

fa Summary of the fast alpha routines. 

f aclear Clears a rectangle area of the display. 

facolors Sets the font foreground and background colors for the 

currently activated fast alpha font. 

f acursor Positions and enables/disables the fast alpha cursor. 

fafont activate Activates a fast alpha font. 

f af ontload Loads a font file into the font cache and activates it. 
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f af ontremove 
fagetinfo 
f ainit 

f arectwrite 
f aroll 
fasetinfo 
faterminate 
fawrite 



Removes a font from the font cache. 

Gets information about the current fast alpha environment. 

Prepares a fast alpha display for output, sets the display's 
fast alpha environment to default values. 

Fills a retangular area with a character. 

Rolls a rectangular area. 

Sets information about the fast alpha environment. 

Terminates the current fast alpha environment. 

Writes characters in the active font. 



Font Manager Calls 

fm_activate Activates a font. 



fm_clipf lag 

fm_clipliin 

fm_colors 

fm.fileinfo 

fm_fontdir 

fm_getname 

fin_load 

fm_opt 

fm_r aster info 

fm_remove 

fm_sixteen_bit 

fin_str_len 

fm_styleinfo 

fin_ write 



Sets clipping flags. 

Sets the clipping limits. 

Sets the active font's foreground and background colors. 

Returns the size of cells in a font file. 

Sets the direction to write characters. 

Translates a font ID to a filename. 

Loads a font into memory. 

Optimizes character generation if possible. 

Returns the size of cells in a font. 

Removes a font from memory. 

Sets sixteen bit font string flag. 

Determines the pixel length of a character string. 

Returns style information about a font. 

Writes characters to the display. 
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The Fast Alpha Library 



The fast alpha display library provides high-performance alpha (textual) capa- 
bilities with bit-mapped graphics displays and graphics windows. For example, 
you can write text and manipulate fonts, you can clear a portion of a display, or 
you can scroll part of a display. The following topics are covered in this chapter: 

■ Concepts essential to using fast alpha routines. 

■ Initializing and terminating the fast alpha environment. 

■ Changing the fast alpha environment. 

■ Cursor control. 

■ Writing characters. 

■ Font manipulation. 

■ Clearing part of a display or window. 

■ Scrolling part of a display or window. 



Concepts 

This section discusses concepts essential to understanding the use of fast alpha 
routines. The following topics are discussed: 

■ The fast alpha programming model. 

■ Cursor positioning. 

■ Character enhancements. 

■ Fast alpha rectangles. 
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Note Definitions of fast alpha constants and structures are found in 

the file /usr/include/fa.h. 

Also, programs that call fast alpha routines require that both the 
fast alpha and font manager libraries be linked. 



Programming Model 

You can use fast alpha routines with any bit-mapped display or graphics window. 
In other words, you can call fast alpha routines to work with bit-mapped 
displays or windows on bit-mapped displays. It's the same concept as using 
Starbase graphics routines with either a bit-mapped display or graphics window. 
(Throughout this chapter unless otherwise indicated, the term display is used to 
indicate both bit-mapped display and graphics window.) 

Note Fast alpha routines are supported on all bit displays but not on 

all drivers. See the Starbase Device Drivers Library manual to 
determine if fast alpha routines are supported by a particular 
driver. 

Certain tasks must always be performed in programs that call fast alpha routines. 

1. Get the file descriptor. 

2. Initialize the fast alpha environment. 

3. Use the fast alpha environment. 

4. Terminate the fast alpha environment. 

5. Close the device interface. 

Get the File Descriptor 

Fast alpha routines require the file descriptor of the display's or the window's 
opened device interface. 

When using fast alpha routines you must obtain a file descriptor for the display by 
performing a graphics open (gopen(3G)) on the display's device interface. The 
file descriptor returned from the gopen function is the one used by fast alpha 
routines. 
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Note If you are using fast alpha routines to combine text and graphics, 

you should obtain separate file descriptors for fast alpha routines 
and Starbase routines; that is, you must open the display once 
for fast alpha routines and once for Starbase routines. 

Getting separate file descriptors ensures that fast alpha routines 
work predictably. If you use the same file descriptor for both fast 
alpha and Starbase routines, the results are unpredictable. 



Initialize the Fast Alpha Environment 

Before calling any other fast alpha routines, you must initialize the fast 
alpha environment for the display on which the routines operate. Once 
the fast alpha environment is initialized, you can call fast alpha routines 
that manipulate the display. When you are finished using the fast alpha 
routines with a display, the fast alpha environment must be terminated. (The 
section "Initializing/Terminating the Fast Alpha Environment" contains more 
information on how to do this.) 

You can use window library routines on the window before, during, and after 
initializing and terminating the fast alpha environment; however, you can use 
fast alpha routines only between initializing and terminating the environment. 

Close the Device Interface 

The final task that must be performed in fast alpha programs is closing the device 
interface of the display. Use the gclose(3G) on the display's device file. 

Cursor Positioning 

The position for placing characters is specified by character column and line, 
rather than display pixels. The leftmost column of the display is column 0; the 
topmost row is row 0. 

The pixel coordinate equivalents of column-row depend on the size of the current 
font — the smaller the font, the smaller the pixel coordinates; the larger the font, 
the larger the pixel coordinates. The results are unpredictable when you use 
proportionally spaced fonts because fast alpha routines use the height and width 
of the largest character for determining spacing. 
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Character Enhancements 

Each character may be enhanced with one or more video enhancements. Inverse 
video and underhning are currently the only enhancements supported. 

When you initialize the fast alpha environment, font colors default to white 
foreground and black background — white characters on a black background. 
Through fast alpha routines, you can redefine the font foreground and background 
colors. 

Fast Alpha Rectangles 

Many fast alpha routines reference rectangles. Rectangles are your means of 
specifying a particular subset of the display area (in columns and lines) for a fast 
alpha operation involving more than one line. The rectangle structure is defined 
in /usr/include/fa.h as: 

struct fa_ coordinate 
{ 

int X, y; 
>; 

struct fa_rectangle 

{ 
struct fa_coordinate origin; /* included in displayed rectangle */ 
struct fa_coordinate corner; /* not included in rectangle */ 

}; 
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As the comment indicates, the lower-right-corner character is not included in the 
rectangle as is consistent with C-language arrays. For example, f a_rect defined 
as: 

struct fa_rectangle fa_rect; /* fast alpha rectangle structure */ 



fa_rect .origin. X = 2 
fa_rect. origin. y = 1 
fa_rect .corner .X = 4 
fa_rect .corner. y = 4 



specifies the following 


rectangle 




columns 




012345 




0. 






1. 


.XX.. 


rows 


2. 


.XX.. 




3. 


.XX.. 




4. 






5. 





This method of display access is fairly low-level, and you may want to build a 
"friendlier" interface upon this base. The main purpose of the fast alpha routines 
is to provide you with a fast and intuitive method for getting alpha information 
on the display. 
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Initializing/Terminating the Fast Alpha Environment 

The f ainit routine initializes the fast alpha environment for a display device; the 
f aterminate terminates a display's fast alpha environment — that is, it releases 
resources allocated when f ainit was called. 

Initializing the Fast Alpha Environment 

To initialize a display's environment, call f ainit. 

tdLiiilt (gfd, driver) 

Set the driver parameter to FAWINDOW. The gfd parameter is the file descriptor 
for the display. 

Initializing the fast alpha environment causes environment information to be 
allocated for the display. This information affects how fast alpha routines work 
with the display. You can inquire and change this information with fast alpha 
routines (discussed in the next section, "Changing the Fast Alpha Environment"). 

Terminating the Fast Alpha Environment 

To terminate a display's environment, call f aterminate. 

f at erminat e (gfd) 

Calling this routine deallocates fast alpha environment information for the display 
device represented by gfd. (In order to use fast alpha routines again, you must 
call f ainit again.) 

Example 

When compiling a fast alpha program, you must compile it with several libraries. 
These libraries are described fully in the chapter "Compiling FA/FM Programs" . 
The following shell script is used to compile most of the example programs in this 
manual. Remember to use the device driver for your display interface (98550 is 
used in these examples). 

PR0G=$1 

cc -o $PROG $PROG.c -If a -Ifontm -ldd98550 -Isbl -lsb2 
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The following code segment exemplifies the structure of programs that call fast 
alpha routines. 

#include <fa.h> /* get fast alpha defs */ 

#include <starbase.c.h> /* get starbase defs */ 

mainO /* progreun " Structure. c" */ 

int gfd; /* file descriptors */ 

/* open the device or window */ 
if ((gfd = gopen("/dev/crt", OUTDEV, "hp98550" . INIT)) == -1) 
exit(l) ; 

fainit(gfd, FAWINDOW) ; /* initialize the fast alpha env. */ 

/* Do writes and other things here */ 

/* */ 

faterminate(gfd) ; /* terminate the environment */ 

gclose(gfd); /* close the device */ 

} 
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Changing the Fast Alpha Environment 

As described in the previous section, fast alpha environment information is 
allocated when you initialize the environment. This information affects the 
manner in which fast alpha routines work. 

The exact information maintained in the fast alpha environment is defined by the 
fainfo structure in the header file fa.h. The table on the following page briefly 
describes each of fainfo^ s fields; for more information on this structure and its 
values, see fa.h and the reference pages for fasetinfo. 

Getting Environment information 

To get the current fast alpha environment for a display, call f agetinf o. 

fagetinf o(^g/(i, fainfoptr) 

The fainfoptr parameter is a pointer to a fainfo structure as defined in fa.h. After 
calling f agetinf o, the fields of the structure return the fast alpha environment 
values specified by gfd. 

Setting Environment Information 

To set fast alpha environment parameters for a display, call fasetinfo. 

f as et inf o (gfd, fainfoptr) 

The fainfoptr parameter is a pointer to a fainfo structure containing the new 
values for the environment. You can set only the following parameters with this 
routine: 

■ default enhancements 

■ clearbef orewrite 

■ colormode 

■ make current 
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Table 2-1 . The fainfo Structure^ 



Field 


Description 


Range 


size 


This is a rectangle structure as defined in 


Limits of 




the "Concepts" section; it defines the display 
size. 


display 


capabilities 


You may use the contents of this field to 
detect what additional capabilities are 
available on a particular device. 


FAWINDOW 


enhancements 


This bit-mask defines the default 
enhancements that are supported on the 
display device. 


(see fa.h) 


default enhancements^ 


Initially set to a value that optimizes the 
performance of the display (FAOFF). 


(see fa.h) 


cursor 


TRUE if the cursor can be physically removed 
from the display device and is FALSE 
otherwise. Currently always TRUE. 


TRUE/FALSE 


fontcellheight 


Indicate the pixel height and width of the 




fontcellwidth 


active font. 




clearbeforewrite^ 


Determines whether the background 
is automatically cleared before writing 
characters. The default value is TRUE, which 
causes the background to clear before 
writing. 


TRUE/FALSE 



^ All fields of the fainfo structure are 32-bit integers; this provides compatibility 

with other languages. 
^ You can change only these fields with fasetinfo. 
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The fainfo Structure (continued) 



Field 


Description 


Range 


foregroundplanes 


Specifies the number of memory planes 


0, 1, 4, or 8 


backgroundplanes 


available for controlling the foreground and 
background colors, respectively. 




colormode^ 


Indicates color option currently in use. 


FAWONB, 




Default is FAWONB (white on black). 


FACOLOR, 
FABONW 


makecurrent^ 


This bit-mask controls the updating of fast 
alpha operations to the display. Various bits 
in the mask control when information is 
displayed with fast alpha routines. 


(see fa.h) 



You can change only these fields with fasetinfo 
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Performance Considerations 

■ You can set default enhancements to a different value, however, it 
initially contains the value that makes the fast alpha library work most 
efficiently (that is, FAOFF). Therefore, changing the value of this parameter 
may degrade system performance. 

■ The default value for clearbef orewrite is TRUE which clears the display 
background before writing any characters. This ensures that the space 
where characters are displayed is properly cleared, so that new characters 
are readable. You can change this value to FALSE, in which case the 
background is not cleared before writing, and you are responsible for 
controlling the background area. 

■ Changing the colormode parameter to FACOLOR causes the fast alpha 
routines to run slower. Black and white colors (the default) cause the 
routines to run faster. 

■ To increase the speed of fast alpha routines, you may wish to suppress the 
updating of the display until several write operations are queued. Then, 
when updating is desired, signal the fast alpha environment to update 
by setting the makecurrent field to MCALWAYS. Queued operations are 
displayed at that time. Then reset makecurrent so that operations are 
queued up — that is, set the bits in makecurrent that suppress display 
updates (see fa.h). By doing this you are making effective use of the 
Starbase buffering facility. 

The default value is MCALWAYS, which updates the display after every fast 
alpha call and may degrade system performance (compared to queueing). 
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Example 

The following code segment sets clearbef orewrite to TRUE and sets makecur- 
rent so that the display won't be updated for any fawrite operations — that is, 
writes are queued. Later on, makecurrent is reset so that all queued fawrite 
operations are performed. 

#include <fa.h> /* get fast alpha defs */ 

#include <starbase.c.h> /* get starbase defs */ 

mainO /* program "Fainfo.c" */ 
{ 

int gfd; /* file descriptors */ 

struct fainfo fa_env; /* FA environment structure */ 

/* open the device or window */ 

if ((gfd = gopen("/dev/crt". OUTDEV. "hp98550". INIT)) == -1) 
exit(l) ; 

fainit(gfd, FAWINDOW) ; /* initialize the fast alpha env. */ 

if (faget info (gfd, &fa_env) < 0) { /* get the current environment */ 
perror("fagetinfo gfd") ; 
exit(l); 
} 

/* Set the appropriate values in the structure and call fasetinfo: 

Always clear the area before writing 
Do not update area until the makecurrent field is reset */ 

fa_ env. clearbef orewrite = TRUE; 

fa_ env. makecurrent = (NOMCONFAWRITE I NOMCONFARECTWRITE) ; 

if (fasetinfo (gfd. &fa_env) < 0) { 

perror( "fasetinfo gfd NOMCONFAWRITE (S) ") ; 

exit(l); 

} 
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/* Do writes and other things here */ 

/* */ 

/* Set makecurrent to make current always to dispaly queued writes */ 
f a_ en V. make cur rent = MC ALWAYS; 
if (fasetinfoCgfd, &fa_env) < 0) < 

perrorC'fasetinfo gfd MCALWAYS") ; 

exit(l) ; 

} 

faterminate(gfd) ; /* terminate the environment */ 

gclose(gfd); /* close the device */ 

} 



Cursor Control 

With fast alpha routines, you can display and move a cursor on displays. The 
f acursor routine performs cursor control operations. 

Procedure 

To move and/or turn the cursor on or off, cah f acursor. 

fa.cur SOT (gfd, column, line, cflag) 

The column and line parameters specify the column and line at which to position 
the cursor; the top line of the display is line 0, and the leftmost column is column 
0. If either column or line is invalid (or equals FACURSORNOMOVE) , the cursor's 
position is not updated. 

The cflag parameter determines whether or not the cursor is displayed. If cflag is 
TRUE, the cursor is displayed; if FALSE, the cursor is turned off. Turning the cursor 
on or off doesn't in itself change the cursor position as fast alpha remembers it. 

If you specify invalid coordinates for column and line — specifically, FACUR- 
SORNOMOVE as defined in fa.h — the cursor won't move, but cflag is still effective. 
This is useful if you wish to turn on/off the cursor at its current position. 
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If part of the window is off screen, the desired cursor position may also be off 
screen. For example, if the upper-left corner of the window is off screen, 0, are 
valid cursor coordinates, but the cursor is not be visible; it is off screen. 

Also, you can specify a cursor position that might be occluded by windows higher 
up in the display stack. 

Precautions 

The cursor is actually a displayable character taken from the currently active 
font. Therefore, if no font is activated, the cursor is automatically turned off. 
Attempting to turn the cursor on when no font is active results in an error. 

Examples 

The following program turns on the cursor at column 27 and line 12. It pauses 
for 3 seconds and then turns off the cursor. 

#include <fa.h> 
#include <starbase . c . h> 

mainO 
{ 

int gfd; 

/* open the device or window */ 
if ((gfd = gopen("/dev/crt". OUTDEV. "hp98550" . INIT)) == -i) 
exit(l) ; 

fainit(gfd, FAWINDOW) ; /* initialize the fast alpha env. */ 

facursor(gfd. 27.12, TRUE); 

sleep(3) ; 

facursor(gfd. FACURSORNOMOVE . FACURSORNOMOVE , FALSE); 

faterininate(gfd) ; /* terminate the environment */ 

gclose(gfd); /* close the device */ 



/* 


get fast alpha defs 


*/ 


/* 


get starbase defs 


*/ 


/* 


program "Cursor. c" 


*/ 


/* 


file descriptors 


*/ 



2-14 The Fast Alpha Library 



Writing Characters 

Fast alpha routines provide two kinds of writing operations. You can write a 
string of characters, or you can fill a rectangle with a specific character. Following 
are separate discussions for writing strings and filling rectangles. 

Writing Character Strings 

To write character strings, use the fawrite routine. 

faviTlte (gfd, column, line, charbuf, ebuf, nchars) 

The column and line parameters specify the character location where the string 
should start in the display. 

The charbuf parameter is a pointer to the buffer of characters to be written. This 
buffer contains nchars characters. That is, fawrite writes nchars characters, 
taking characters from the address specified by charbuf. 

The ebuf parameter is a pointer to a buffer of enhancements to be applied to 
each character in charbuf; ebuf can be either NULL (no characters at all) or can 
contain nchars characters: 

■ If ebuf is NULL, then the enhancements specified in default enhancements 
are made to each character in the output string. 

■ Otherwise, each character in ebuf defines the enhancement (s) (such 
as inverse or underlining) to use when displaying the corresponding 
character in charbuf. For example, the fifth character in ebuf defines 
the enhancement (s) to use when displaying the fifth character in charbuf. 

Valid enhancements are: 



FAOFF 


@ 


FAINVERSE 


B 


FAUNDERLINE 


D 



You can use the full constant name or the letter. 
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Filling a Rectangle 

The f arectwrite routine fills a rectangular area in the display that is specified 
by a rectangle structure. 

farectwrite^^g/c?, character, enhancement, rp) 

The rp parameter is a pointer to a rectangle structure that defines the area to be 
filled. The area is filled with the character specified by the character parameter, 
and the enhancement parameter describes the enhancement (s) to use when 
displaying the character. (If enhancement is NULL, then default enhancements 
are used when displaying character.) 

Example 

The following code segment fills a display rectangle with inverse video X's; the 
rectangle's upper-left corner is at the origin (column 0, line 0). It then writes the 
message: 

What an exciting 
rectangle this is! 

and underlines the word exciting. 



#include <fa.h> 


/* get fast alpha defs 


*/ 


#include <starbase . c . h> 


/* get starbase defs 


*/ 


mainO 

int gfd; 


/* program "Structure. c" 


*/ 


/* file descriptor 


*/ 


struct fa_rectangle rp; 


/* rectangle structure 


*/ 
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/* open the device or window */ 
if ((gfd = gopen('7dev/crt". OUTDEV. "hp98550" . INIT) ) == -1) 
exit(l); 

fainit(gfd, FAWINDOW) ; /* initialize the fast alpha env. */ 

rp. origin. X =2; /* define the area of the rectangle */ 

rp. origin. y = 5; 

rp. corner. X = 23; 

rp. corner. y = 9; 

farectwriteCgfd, 'X'. FAINVERSE, &rp) ; /* write Xs into the rectangle */ 

/* Now write the first line into the rectangle: 

@ — > FAOFF (no enhancements) 

D --> FAUNDERLINE (underline the text) 
B --> FAINVERSE (inverse the text) . */ 

fawrite(gfd. 4, 6. "What an exciting", "@@®®®@®@DDDDDDDD" . 16); 
fawrite(gfd. 3, 7, "rectangle this is!", NULL, 18); /* no enhancements */ 

faterminate(gfd) ; /* terminate the environment */ 

gclose(gfd) ; /* close the device */ 
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Font Manipulation 

The fast alpha hbrary contains font manipulation routines you can use to display 
different fonts. See Appendix A for information about specific font descriptions. 

Concepts 

At fast alpha initialization time, a default font is established. If a font has 
already been established with font manager routines (discussed in the next 
chapter), that font is used. If there is no active font at initialization, a system 
default font is activated (the font specified by the WMBASEFONT environment 
variable). You can change the current font with fast alpha routines or font 
manager routines; however, it is recommended that once you've started using 
the fast alpha environment, you should make font changes using only the fast 
alpha routines. This ensures that the fast alpha environment is always aware of 
the current font attributes (such as height, width, and colors). 

Unlike the termO font management model, there is no notion of base and alternate 
fonts, there is only the active font. Any text written is always displayed in the 
active font. 

Fonts are loaded into the fast alpha font cache from the font directories described 
in the termO font management model. Loading a font causes it to be the 
active font. The fast alpha font cache is not the same one used by termO font 
management routines. However, the fast alpha font cache is the same as the font 
manager's. (In fact, to perform font management, the fast alpha routines call 
font manager routines.) 

When you are through using a font, you can remove it from the font cache. 

Fast alpha fonts are often denoted by font ids. These are not the same as termO 
font ids but are the same as font manager font ids. Attempting to intermix termO 
and fast alpha font ids may result in unpredictable system behavior. 
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Loading a Font 

To load a font into your font cache, call the f af ontload routine. 

faf ontload(^g/c?^ path) 

The path parameter is the path name of the font file to load. When the font 
is loaded, it is automatically activated, and faf ontload returns a font id that 
identifies the font. This font id is required as a parameter to some other font 
routines. This font id is local to the associated gfd. It is not a valid id for any 
other gfd, nor is it valid to any other process. 

Activating a Font 

To activate a loaded font that isn't currently active, call fafont activate. 

faf ontactivatef^g/d, fontid) 

This routine activates, as the current font, the font specified by fontid {fontid is 
the value returned by faf ontload). After calling this routine, any text written 
subsequently is displayed in the new font. 

Removing a Font 

When you are finished using a font, you can remove it from the font cache. The 
f af ontremove routine removes a font from the cache. 

faf ontremove(^p/c/, fontid) 

After calling this routine, the font specified by fontid no longer exist in the font 
cache. To use this font again, you must reload and reactivate it. 

Setting Font Colors 

You set the foreground and background colors used when displaying fonts with 
the f acolors routine. 

facoloTs (gfd, foreground^ background) 

After calling this routine, the active font's foreground and background colors are 
set to those specified by the foreground and background parameters. These colors 
are indices into the Starbase color map. 
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Supported values are determined by the display device: or 1 for monochromatic 
displays, to 15 for 4-plane color, and to 255 for 8-plane color. 

If the colormode field of the fainfo structure is not set to FACOLOR, the system 
ignores any color changes. 

Calling this routine also causes the fast alpha environment to take note of the 
current font attributes (that is, width, height, color, etc.). 

Precautions 

The cursor is actually a displayable character and is taken from the currently 
active font. Therefore, if no font is activated, the cursor is automatically turned 
off. Attempting to turn the cursor on when no font is active results in an error. 

Example 

The following code segment loads an 8 by 16-pixel bold font into the font cache, 
activates the font, then writes "HELLO" several times in various colors. 



#include <fa.h> 
#include <starbase.c.h> 

mainO 
{ 

int gfd; 

int fid; 

int i; 

struct fainfo fa_env; 



/* get fast alpha defs */ 

/* get starbase defs */ 

/* program "Fonts. c" */ 

/* file descriptor */ 

/* font id */ 

/* index for looping */ 
/* FA environment structure */ 



if ((gfd = gopen("/dev/crt". OUTDEV, "hp98550" , INIT)) == -i) 
exit(l); 



fainit(gfd, FAWINDOW) ; 

fagetinf o(gfd, &fa_env) ; 
fa.env. colormode = FACOLOR; 
fasetinfo(gfd, &f a_env) ; 



/* initialize the fast alpha env. */ 

/* get the current environment */ 
/* set up the color mode */ 



/* Load the bold font into the font cache */ 
if ((fid = fafontload(gfd. 

"/usr/lib/raster/8xl6/SNF/lp.b.8U")) ==-!){ 
perrorC'fafontload gfd"); 
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exit(l) ; 
} 

/* Activate the font */ 
if (fafontactivateCgfd. fid) == -1) { 
perror("fafontactivate gfd"); 
exit(l); 
} 

for(i=0; i<8; i=i+2){ /* Change colors and write message */ 

facolorsCgfd, i. i+1) ; 

fawriteCgfd. i.i. "HELLO" , NULL. 5) ; 
} 

/* Remove the bold font from the cache */ 
if (faf ontremoveCgfd, fid) == -1) { 
perror("fafontremove gfd") ; 
exit(l) ; 
> 

faterminate(gfd) ; /* terminate the environment */ 

gclose(gfd); /* close the device */ 



Clearing a Rectangle 

You can clear or erase any rectangular area of characters in a display. For 
example, you could clear the entire display. The f aclear routine is used for 
this purpose. 

To clear a rectangle, call the f aclear routine. 

faiClea.T (gfd, enhancements, rp) 

The rp parameter is a pointer to a rectangle structure that defines the rectangle 
to clear. 

The enhancements parameter is currently ignored by the system and is reserved 
for future expansion. Leave this parameter set to FAOFF. 



The Fast Alpha Library 2-21 



Example 

The following program fills a rectangle with Xs. It then calls a subroutine to clear 
a different rectangle. 

#include <fa.h> /* get fast alpha defs */ 

#include <starbase.c.h> /* get starbase defs */ 

mainO /* program "Clear. c" */ 

{ 

int gfd; /* file descriptor */ 

int fid; /* font id */ 

int i; /* index for looping */ 

struct fa_rectangle rp; /* rectangle structure */ 

if ((gfd = gopen("/dev/crt". OUTDEV. "hp98550" . INIT)) == -1) 
exit(l) ; 

fainit(gfd. FAWINDOW) ; /* initialize the fast alpha env. */ 

rp. origin. X = 0; 
rp. origin. y = 0; 
rp. corner. X = 15; 
rp. corner. y = 10; 
farectwrite(gfd, 'X'. NULL. &rp) ; 

clear_gr(gfd. 5, 5, 10. 10); 

faterminate(gfd) ; /* terminate the environment */ 

gclose(gfd); /* close the device */ 

> /* end of main */ 

clear_gr(gfd, row, col, x_chars, y_chars) 

int gfd; /* gopened file descriptor */ 

int row. col; /* starting row and column */ 

int x_chars, y_chars; /* number of characters */ 

struct fa_rectangle rect; /* rectangle to be cleared */ 

rect .origin. x = row; /* define the rectangle to be cleared */ 
rect .origin. y = col; 
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rect .corner .X = row + x_chars; 
rect. corner. y = col + y_chars; 

/* clear the rectangle */ 
if (faclearCgfd, FAOFF. ferect) == -1) return(-l); 
return (0) ; 

} /* end of clear_gr */ 



Scrolling a Rectangle 

You can scroll any display area defined by a rectangle structure. The far oil 
routine performs this task. 

fazollfg/d, how, howfar, rp) 

The rp parameter points to a rectangle structure that defines the portion of the 
display to scroll. The how parameter defines the direction to scroll, and the 
howfar parameter defines how many character units to scroll in the direction 
indicated by how. 

The following are valid values for how: 

u FAROLLUP ('u') — roll the rectangle's contents up. 

■ FAROLLDOWN ('d') — roll the rectangle's contents down. 

■ FAROLLLEFT ('1') — roll the rectangle's contents left. 

■ FAROLLRIGHT ('r') — roll the rectangle's contents to the right. 

If you move text out of the rectangle area using scrolling, and then move it back 
into the area, the text is not rewritten. 

Example 

The following code segment rolls a display's contents in all four directions: up, 
right, down, left. 

#include <fa.h> /* get fast alpha defs */ 

#include <starbase.c.h> /* get starbase defs */ 

mainO /* program "Roll.c" */ 
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int gfd; /* file descriptor */ 

int fid; /* font id */ 

int i ; /* index for looping */ 

struct fa_rectangle rp; /* rectangle structure */ 

if ((gfd = gopen("/dev/crt". OUTDEV. "hp98550" . INIT)) == -1) 
exit(l) ; 

fainit(gfd. FAWINDOW) ; /* initialize the fast alpha env. */ 

rp. origin. X =4; /* outline the rectangle */ 

rp . origin . y = 4 ; 
rp. corner. X = 16; 
rp. corner. y = 11; 
farectwrite(gfd, 'X', NULL, &rp) ; 

rp. origin. X =5; /* make the rectangle 1 unit smaller */ 

rp. origin. y = 5; 

rp. corner .X = 15; 

rp. corner. y = 10; 

farectwrite(gfd. 'Y', FAINVERSE. &rp) ; /* this data will move */ 

sleep(l) ; 

/* Roll the contents of the window up 1 line */ 

if (farolKgfd, 'u' . 1. &rp) == -1) { 
perror("faroll up") ; 
exit(l); 
} 

sleep(l) ; 
/* Roll the contents of the window right 1 characters */ 

if (farolKgfd. 'r'. 1, &rp) == -1) { 
perror("faroll right"); 
exit(l) ; 
} 

sleep(l) ; 
/* Roll the contents of the window down 2 line */ 

if (farolKgfd, 'd' , 2, &rp) == -1) { 

perror("faroll down") ; 

exit(l) ; 
> 
sleep(l) ; 
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/* Roll the contents of the window left 3 characters */ 

if (farolKgfd. '1'. 3. &rp) == -1) { 
perrorC'faroll left"); 
exit(l); 
} 

faterminate(gfd) ; /* terminate the environment */ 

gclose(gfd) ; /* close the device */ 
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3 



The Font Manager Library 



The font manager library provides a high-performance, low-level textual interface 
to graphics windows and bit-mapped displays. This library's functionality 
overlaps with the fast alpha library, and in fact, some fast alpha routines call font 
manager routines. However, the font manager provides some powerful capabilities 
not provided by the fast alpha library. 

There are two main differences between the font manager and fast alpha libraries: 

1. Font manager uses pixel units to specify character coordinates; fast alpha 
uses character column and line addressing. 

2. Font manager can operate with proportionally spaced fonts; fast alpha 
cannot. 

The following topics are discussed in this chapter: 

■ Concepts essential to using font management routines. 

■ Font management. 

■ Writing characters. 

■ Character clipping. 

■ Font information routines. 
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Concepts 

Font manager routines can be used with either bit-mapped displays or graphics 
windows. The routines require the file descriptor returned from performing a 
graphics open (gopen(3G)) on the device interface for the display. 

Not8 Fast alpha routines are supported on all bit displays but not on 

all drivers. See the Starbase Device Drivers Library manual to 
determine if fast alpha routines are supported by a particular 
driver. 

The font manager is a distributed library that is controlled by the graphics 
resource manager daemon (grmd) and a set data structure kept in shared memory 
common to all users of the font manager. This holds true in all environments; 
XI 1 revision A.Ol. dd, Windows/9000, and raw bit mapped displays. 

Font manager routines allow you to load, activate and remove fonts, and change 
attributes that affect how a font is displayed. The font management model is 
identical to that used by fast alpha routines. In fact, fast alpha routines call font 
manager routines to perform font management tasks. 

Fonts on the system will never be loaded more than once from the same font 
file. Once a font is loaded by a process, any other process can open and share a 
copy of that font. The shared copy will not be removed from the system until all 
processes have released the font. 

NotG Definitions from the /usr/include/f onticon.h header file are 

used throughout this chapter. 
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Font Management 

The font manager library contains font management routines used to display 
different fonts on displays. 

Concepts 

Like the fast alpha routines, the font manager maintains a font cache (or font 
table). The font table is an area of memory used by the font manager. Font 
information is loaded into the font table from font files. 

Windows/9000 font files are stored in the directory — subdirectory 
/usr/lib/raster. See Appendix A for information about specific Windows/9000 
font descriptions. 

Fonts under /usr/lib/raster are in two formats — the original Windows/9000 
format and Server Natural Format (SNF). The SNF versions are used by the 
FA/FM libraries with the Series 300 6.5 release, Series 800 3.1 release, or later 
releases. The SNF versions are always located in a subdirectory below the original 
Windows/9000 version. The subdirectory is called SNF. For example, there is 
a Windows/9000 format font /usr/lib/raster/8xl6/lp.8U; its corresponding 
SNF font is /usr/lib/raster/8xl6/SNF/lp.8U. scf . 

The Series 300 6.5 release, Series 800 3.1 release, or later releases of the FA/FM 
libraries can also load XI 1 fonts. The XI 1 fonts are also in SNF and can be found 
under the directory /usr/lib/Xll/f onts. 

When you load a font with font manager routines, it automatically becomes the 
active font. Text is always displayed in the active font. You use font manager 
routines to activate any font you have loaded. 

In addition, when you load a font, a unique font id is returned. This font id is 
used to identify the font to certain font management routines. Font manager font 
ids are different than those used by termO font management routines; these ids 
should not be mixed. 

Loaded fonts can be different sizes. By using font manager routines, you can mix 
different-sized fonts on the same display. 
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When you are finished using a font, you must always remove it from the font 
table. Loading and removing a font is analogous to opening and closing a file — 
after you open a file, you must eventually close it. 

As mentioned previously, with windows the font table is shared by all users of 
the font manager library. Therefore, several users may be using the same font 
in the font table. The font manager takes care not to duplicate fonts in the font 
table. When a user attempts to load an already- loaded font, the font manager 
takes note that another user is using the font. It does not reload the font into 
the table. 

The same is true for removing fonts. If more than one user is using the same 
font, the font manager doesn't actually remove the font from the table; it takes 
note that one less user is using the font. If only one user is using a font, removing 
the font causes the font manager to remove it from the table. 

Never assume that a font exists in the font table unless you've loaded it and 
haven't yet removed it. If you remove a font, there's no guarantee that it still 
exists in the table because others using the font might remove it. Remember: 
Don't make any assumptions about the shared memory. Load and remove fonts 
as if you're the only user. 

The foreground and background colors of the active font default to white on 
black. On color systems, you can redefine the foreground and background colors 
to any from the system color map. 

Loading a Font 

To load a font into the font table, call f m_load. 

fiii_load(^gr/(r/, path, fontid) 

The path parameter points to the path name of the font file to load into the font 
table. The fontid parameter returns the font's id. 

The Series 300 6.5 release. Series 800 3.1 release, or later releases of the FA/FM 
libraries will only load SNF font files. If the font to be loaded is not an SNF 
version, the FA/FM libraries will automatically try to load a font from the 
subdirectory SNF. Fonts in standard Server Natural Format are suffixed by . snf . 
The FA/FM libraries also know how to load compressed Server Natural Fonts. 
These fonts are suffixed by . scf . 
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If the Series 300 6.5 release, Series 800 3.1 release, or later releases of the FA/FM 
libraries were told to load the font /usr/lib/raster/8xl6/lp.8U, they would 
try to open one of the following files: 

/usr/lib/rast er/8xl6/lp . 8U . snf 
/usr/lib/raster/8xl6/lp . 8U . scf 
/usr/lib/raster/8xl6/SNF/lp . 8U. snf 
/usr/lib/rast er/8xl6/SNF/lp . 8U. scf 

In this order, the first file that was a valid SNF file would be loaded. Thus, 
programs that used FA/FM libraries released before the Series 300 6.5 release, 
Series 800 3.1 release, or later releases will not need to have their font paths 
changed. 

In addition to being loaded, the font automatically becomes the active font. So 
if you want a font other than the one loaded to be the active font, you must 
activate the other font. 

When you are finished using a loaded font, you must remove it. 

Activating a Font 

To activate a previously loaded font, call fm_activate. 

f m_aiCt±Y ate (gfd, fontid) 

The font represented by the fontid parameter is made the active font. All text is 
displayed in the new font until the next call to fm_activate, or until you load a 
new font. 

When you activate a new font, the color is re-set to black and white. 

Removing a Font 

To remove a loaded font, call fm_remove. 

f m_r emo V e (gfd, fontid) 

After calling this routine, the font specified by fontid is removed from the font 
table (as far as your application is concerned). 

If you've accidentally loaded a font twice, you must also remove it twice. 
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/* get starbase defs 


*/ 


/* program "FM.Struct .c" 


*/ 


/* file descriptor 


*/ 


/* font id 


*/ 



Example 

The structure of a font manager program is shown in the following example. 
#include <starbase . c . h> 

mainO 

int gfd; 
int fid; 

if ((gfd = gopen("/dev/crt", OUTDEV. "hp98550" . INIT)) == -i) 
exit(l) ; 

/* Load the font; the font is automatically activated */ 
fm_load(gfd. "/usr/lib/raster/8xi6/SNF/lp.8U.scf ", &f id) ; 

* * 

* Do writes and other routines here * 

* * 

fm_remove(gfd, fid); /* Remove the font */ 

gclose(gfd) ; /* Close the device */ 

> 
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Writing Characters 

With font manager routines, you can write text in the active font to any display. 
By default, characters are written from left to right; however, characters can be 
written in any direction — up, down, to the right, or to the left. You can write the 
characters in any color supported on your system. In addition, you can optimize 
the generation of characters on your particular display hardware. 

Writing Characters 

The fm_write routine displays character strings on a display. 

fm_vir±te(gfd, x,y, str, numchars, dump, colormode) 

The str parameter points to the string to write, and numchars indicates the 
number of characters in the string. 

The pixel coordinantes indicating where to write the string are specified by x,y. 
The upper-leftmost pixel in the contents area has coordinates 0,0. 

Current write direction determines how the characters are positioned with respect 
to the x,y coordinates. The next figure illustrates character positioning. 

The dump parameter indicates whether or not to immediately update the display 
after the write: TRUE means to update; FALSE means to let the system-imposed 
buffering take care of the visual update. 

The colormode parameter determines whether or not to use colors from the 
previous call to fm_colors. If TRUE, the area where the characters are written 
is cleared to the current background color, and the characters are written in 
the foreground color. Setting this parameter to TRUE is analogous to setting 
clearbef orewrite to TRUE in the fast alpha environment. This mode has the 
side effect of leaving the colormode Sind write-enable masks set as needed. 

If colormode is FALSE, the characters are displayed using the current Starbase 
graphics replacement rule and write mask. For example, if the current 
replacement rule is to OR the image onto the background, the characters are 
placed over the background image without erasing it. Setting colormode to FALSE 
is somewhat analogous to setting clearbef orewrite to FALSE in the fast alpha 
environment. 
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Controlling the Write Direction 

By default characters are written to the right. By using the fin_f ontdir routine, 
you can write characters in any horizontal or vertical direction. 

fm_fontd±T (gfd, direction) 

After calling this routine, any characters written to the display with the f m_write 
routine are written in the direction specified by the direction parameter. Valid 
values for direction are: 

■ 'u' — upward, 

■ 'd' — downward, 

■ '1'— to the left, 

■ 'r' — to the right (this is the default). 

This routine affects only the direction of the write and not the characters 
themselves — they are still displayed normally within each character cell. Also, 
the write direction stays in effect until a different font is activated; at that point, 
the direction returns to the default ('r'). 
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Example 

The following example writes in all four directions. Remember that the x,y 
location specifies different corners of the character cell depending on the direction 
you specify. Because of this, the up, right and left directions can share the same 
origin. However, the down direction (or right direction) must have a different 
origin. 

#include <starbase.c.h> /* get starbase defs */ 

mainO /* program "FM_Directions.c" */ 

{ 

int gfd; /* file descriptor */ 

int fid; /* font id */ 

if ((gfd = gopen("/dev/crt". OUTDEV. "hp98550" . INIT)) == -1) 
exit(l); 

fin_load(gfd. "/usr/lib/raster/8xl6/SNF/lp.8U.scf " , &f id) ; 

fni_fontdir(gfd. 'u') ; 

fm_ write (gfd, 80. 100. "Upward". 6. TRUE. FALSE); 

fm_fontdir(gfd. 'd') ; 

fin_write(gfd. 80. 120. "Down", 4. TRUE. FALSE); 

fm_fontdir(gfd. 'r') ; 

fm_write(gfd. 80. 100. "Right". 5. TRUE. FALSE); 

fin_fontdir(gfd. '1'); 

fm_write(gfd. 80. 100. "Left". 4. TRUE. FALSE); 

fin_remove(gfd. fid); /* to remove the font */ 

gclose(gfd); /* close the device */ 

> /* end of main */ 
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Setting Colors 

To change the active font's foreground and background colors, call f m_colors. 

fm_coloTs (gfd, foreground, background) 

The foreground and background parameters specify the new colors to use; they 
are indexes into the Starbase color map. 

Supported values are determined by the display device: or 1 for monochromatic 
displays, to 15 for 4-plane color, and to 255 for 8-plane color. 

The foreground and background colors return to the defaults (black and white) 
whenever a font is activated. 

Example 

The following code segment loads an 8 x 16-pixel bold font into the font cache, 
activates the font, changes its colors to black on white, writes the word "HELLO", 
and removes the font from the cache. 

#include <starbase.c.h> /* get starbase defs */ 

#define BLACK 
#define WHITE 1 



mainO 
{ 

int gfd; 


/* program "FM_Colors.c" 


*/ 


/* file descriptor 


*/ 


int fid; 


/* font id 


*/ 


int i; 






if ((gfd = gopen('7dev/crt". 


OUTDEV, "hp98550", INIT)) == -1) 




exit(l); 







/* Load the font; the font is automatically activated */ 
fm_load(gfd, '7usr/lib/raster/8xl6/SNF/lp.b.8U.scf " . &f id) ; 

for (i=0; i<8; i=i+2)-C 

fm_colors(gfd, i, i+1) ; 

fm_write(gfd. i*10. i*10. "HELLO", 5, TRUE, TRUE); 
> 

f m_remove (gf d , fid); /* Remove the font */ 

gclose(gfd); /* Close the device */ 
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optimizing Character Generation 

Some systems have specialized hardware for writing to bit-mapped displays. 
This special hardware accelerates writing characters to the display. The f m_opt 
routine allows you to take advantage of specialized display hardware. 

fm_oipt (gfd, optmode) 

If optmode is 1, optimization is turned on; if optmode is 0, optimization is turned 
off. 

This routine fails if optimization hardware doesn't exist on the system or if too 
many fonts have been optimized already. This should not be considered a fatal 
error. Therefore, you should not abnormally terminate your program if this 
routine fails. 

Determining String Length 

To determine if a character string will extend beyond the edge of a window or 
display, use the f m_str_len routine to determine the pixel length of any character 
string along the current direction of the active font. 

fT[i_str_len (gfd, str, numchars) 

The str parameter points to the character string containing numchars characters. 

This routine is especially useful if character clipping is disabled (see the 
"Character Clipping" section for details). 
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Example 

The following example writes the message "HELLO" upwards and to the left. The 
origin of the string is determined by using the fin_str_len routine. 



#include <starbase.c.h> 




/* get starbase defs 


*/ 


mainO 
{ 

int gfd; 




/* program "FM_length.c" 


*/ 




/* file descriptor 


*/ 


int fid; 




/* font id 


*/ 


int x.y; 








if ((gfd = gopen("/dev/crt". 


OUTDEV. 


"hp98550". INIT)) == -1) 




exit(l); 









fm_load(gfd, '7usr/lib/raster/8xl6/SNF/lp.b.8U.scf " , &f id) ; 

fin_fontdir(gfd, 'u'); /* determine the length if writing */ 

y = fm_str_len(gfd, "HELLO". 5); /* upwards */ 

fm_fontdir(gfd, '1'); /* determine the length if writing */ 

X = fm_str_len(gfd, "HELLO". 5); /* to the left */ 

fm_fontdir(gfd. 'u'); 

fm_write(gfd, x. y. "HELLO", 5, TRUE. FALSE); 

f m_f ontdir (gfd , ' 1 ' ) ; 

fm_ write (gfd. x. y. "HELLO". 5. TRUE. FALSE); 

fm_remove(gfd. fid); /* Remove the font */ 

gclose(gfd) ; /* Close the device */ 

} /* end of main */ 

Writing Sixteen-Bit Font Strings 

The fm_sixteen_bit routine can be used to put the font manager in six- 
teen-bit-mode. 

f m_sixt een_bit (gfd, sixteeri-hit-mode) 

If flag is 1, sixteeri-bit-mode is turned on; if flag is 0, sixteeri-bit-mode is turned 
off. 

When the font manager is put into sixteeri-bit-mode, character strings are 
interpreted 16 bits per character rather than the standard 8 bits per character. 
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This should not be confused with the use of HP- 15 font files, which are parsed 
into mixed 8-bit and 16-bit portions. Rather, the 16-bit capability here would 
be used for writing pure 16-bit text. This is especially useful when using MIT 
16-bit fonts. These fonts are not a mixture of 8-bit and 16-bit characters. They 
are all 16-bit characters. 



Character Clipping 

Character clipping controls the area in which characters are written. When 
character clipping is enabled, you cannot write characters outside the established 
clip limits. You can enable or disable cHpping and redefine clip limits with font 
manager routines. 

By default, when a graphics window is created, clipping is enabled and the clip 
limits are always set to the current window size. The default clip limits of a 
display are the phsical limits of the display. 

Note Memory can become corrupted if clipping is not enabled. This 

is because characters could inadvertently be written outside the 
display memory established by the clip limits. Conceivably, you 
could write spurious data into your data structures and your 
program. 

If you do not use clipping, be sure to check the length of every 
character string (with f m_str_len) to ensure that displaying the 
string will not cause it to extend outside the display boundaries. 



Enabling/Disabling Clipping 

To enable or disable clipping for a given display, use the fin_clipf lag routine. 

fm_cl±pflag(gfd, flag) 

The flag parameter indicates whether to enable or disable clipping: if flag is 1, 
clipping is enabled; if flag is 0, clipping is disabled. 
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Setting Clip Limits 

To set clip limits for a display, use the f m_cliplim routine. 

fin_clipliin(^^/d, x,y, width,height) 

The x,y parameters indicate the x,y location of the upper-left corner of the 
clipping rectangle (with respect to the upper-leftmost pixel of the display); 
the width, height parameters define the pixel width and height of the clipping 
rectangle. After calling this routine, characters can be written only within the 
defined rectangle. 



Example 

The following example writes "X"s across the window. It then sets the clipping 
area to a portion of the window and writes blanks to show the clipped area. 



#inc lude < st arbas e . c . h> 

mainO 
{ 

int gfd; 

int fid; 



/* get starbase defs */ 
/* program "FM_clipping.c" */ 



/* file descriptor 
/* font id 



*/ 
*/ 



if ((gfd = gopen("/dev/crt", OUTDEV, "hp98550" . INIT)) == -1) 
exit(l) ; 

fm_load(gfd, "/usr/lib/raster/8xi6/SNF/lp.8U.scf " , &f id) ; 



fm_write(gfd, 10, 10. "XXXXXXXXXXXXXXXXXXXXXXXXX" . 

fm_write(gfd. 10. 20. "XXXXXXXXXXXXXXXXXXXXXXXXX". 

fm_write(gfd. 10. 30. "XXXXXXXXXXXXXXXXXXXXXXXXX". 

fm_write(gfd. 10. 40. "XXXXXXXXXXXXXXXXXXXXXXXXX". 

fm_write(gfd, 10. 50. "XXXXXXXXXXXXXXXXXXXXXXXXX". 

fm_write(gfd. 10. 60. "XXXXXXXXXXXXXXXXXXXXXXXXX". 

fin_write(gfd. 10. 70. "XXXXXXXXXXXXXXXXXXXXXXXXX". 

fm_write(gfd. 10. 80. "XXXXXXXXXXXXXXXXXXXXXXXXX". 

fm_write(gfd, 10. 90. "XXXXXXXXXXXXXXXXXXXXXXXXX". 



25. TRUE. FALSE) 

25, TRUE. FALSE) 

25, TRUE. FALSE) 

25. TRUE. FALSE) 

25, TRUE, FALSE) 

25, TRUE. FALSE) 

25, TRUE. FALSE) 

25, TRUE. FALSE) 

25. TRUE, FALSE) 
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fm.cliplimCgfd, 25. 25. 50. 50) 
fm_clipflag(gfd. 1); 

fm_write(gfd, 10. 10, " 

fiii_write(gfd. 10, 20. " 

fm_write(gfd. 10. 30. " 

fm_write(gfd, 10, 40, " 

fm_write(gfd, 10, 50. " 

fm_write(gfd, 10. 60, " 

fm_write(gfd. 10, 70. " 

fm_write(gfd. 10, 80. " 



. 25. TRUE. FALSE) 
. 25, TRUE. FALSE) 
, 25, TRUE. FALSE) 
. 25. TRUE. FALSE) 
. 25, TRUE, FALSE) 
, 25, TRUE, FALSE) 
, 25. TRUE. FALSE) 
. 25, TRUE, FALSE) 



fm_remove(gfd, fid); 
gclose(gfd) ; 
} /* end of main */ 



/* Remove the font */ 
/* Close the device 



*/ 
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Font Information Routines 

The font manager library provides routines that obtain information about fonts. 
In particular you can inquire: 

■ Font size information. 

■ A font's path name. 

■ Information on a font's style. 

Before discussing how to obtain font information, a discussion of font sizes and 
font styles is needed. 

Font Size 

Font size is actually comprised of three different attributes: width, height, and 
baseline height. 

Font width and height are straightforward. Each character in a font is displayed 
in a font cell. The font cell is the same size for all characters. The font's width 
and height represent the pixel width and height of the font cell. 

All the characters of a given font "sit" on an invisible line called the baseline. The 
"bottom" of each character is flush with this line. However, parts of characters 
can extend below the baseline — for example, the descender that extends below the 
circle on the letter p. The following figure illustrates each of these size attributes. 

The baseline attribute allows you to align different-sized fonts on the same line. 
For example, suppose you are writing a story that starts with "In the beginning," 
and you want the first letter, I, to be in a large font and the rest of the characters 
to be in a normal-sized font. To make the text look more natural, you should 
align the baseline of the big I with the baseline of the normal-sized font. 
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Figure 3-2. Font Size Attributes. 
Getting Font Size information 

Two font manager routines return font size information: fm_fileinfo and 
fm_rasterinf 0. The fm_rasterinf o routine gets size information for fonts in 
the font table. 

fiii_rasterinf o(^g'/d, fontid, width, height, baseline) 

This routine returns the font cell width and height (in pixels) and the basehne 
height (also in pixels) for the font specified by fontid. 

The fin_f ileinf o routine gets size information for a font file. 

fm_f±le±n.fo (path, width, height, baseline) 

This routine returns font size information for the font file whose path name is 
pointed to by path. 
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Note This routine does not accept a gfd parameter and has no way of 

determining which file system fonts are being loaded from. Thus, 
it is assumed that the font path specifies a font file on the local 
file system. 



Example 

The following example writes the phrase "In the beginning" to a window. The 
"I" is in a larger font than the rest of the phrase. To line up the rest of the 
phrase, it is necessary to know the size of the first font used. 



#include <starbase.c.h> /* get starbase defs */ 

mainO /* program "Font_size.c" */ 

int gfd; /* file descriptor */ 

int fid, fid2; /* font id */ 

int big_width, big_height; /* big font cell size */ 

int big_baseline ; /* big font baseline */ 

int small.width, small_height; /* small font cell size */ 

int small.baseline ; /* small font baseline */ 

int offset; /* change in font size */ 

if ((gfd = gopen('7dev/crt". OUTDEV, "hp98550" . INIT)) == -1) 
exit(l) ; 

fm_load(gfd. '7usr/lib/raster/18x30/SNF/pica.8U.scf : . &f id) ; 

fm_write(gfd, 10, 80, "I". 1, TRUE. TRUE); 

fm_rasterinfo(gfd, fid, &big_width, &big_height, &big_baseline) ; 

fm_load(gfd, "/usr/lib/raster/10x20/SNF/lp.8U.scf " . &f id2) ; 
fm_rasterinfo(gfd, fid2, &small_width, &small_height , 

&small_baseline) ; 
offset = big_height - big_baseline - (small_height - small_baseline) ; 
fm_write(gfd, 10 + big_ width, 80 + offset, "n the beginning", 15, TRUE. 

TRUE) ; 

fm_remove(gfd, fid) ; /*Remove the fonts */ 

fm_remove(gfd, f id2) ; 

gclose(gfd); /* close the device */ 

} /* end of main */ 
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Font Style 

Each font has certain attributes that define its style. These attributes are defined 
by the escapecodes structure in the fonticon.h header file. The following table 
briefly defines each of the fields in this structure. 

Table 3-1. 



Item 


Description 


Range 


symbol_int 


Gives the numerical part of the font's 
identification string; e.g., 8 for 8-bit Roman-8 
(8U); for 7-bit math font (OM). The value for 
this field indicates whether the font is 8-bit (=8) 
or 7-bit (=0). 


0, 7, or 8 


typeface 


Specifies the kind of typeface, e.g. pica=l, 
prestige=8, etc. 


to 10 


proportional 


Tells whether the font is uniform width (=0) or 
proportional (=1). 


Oor 1 


hpitch 


Approximates horizontal characters per inch. 


Depends on font 
width. 


vheight 


Approximates vertical characters per inch. 


Depends on font 
height. 


boldness 


Indicates the boldness of the font. The lightest is 
-7, the boldest is 7. 


-7 to 7 


quality 


Describes the quality of the font: data processing 
(=0), near letter quality (=1), or correspondence 
quahty (=2). 


Oto 2 



Getting Font Style Information 

To get font style information, call the fm_styleinf o routine. 

fm_styleinfo(^p/d^ fontid, symboLchar, escapecodes) 

The symboLchar parameter returns a character describing the font (that is, 'U' 
for Roman-8 fonts, 'K' for Katakana fonts). 
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The escapecodes parameter returns an escapecodes structure as defined in 
fonticon.h. Tliis structure contains style information for the font indicated by 
fontid. 

The Windows/9000 fonts all contain the necessary information to surpport the 
fm_styleinf o routine, but not all SNF fonts contain this information. If for any 
reason, any part of this information is missing from the font, a value of -1 will 
be returned in the corresponding field. 

Getting a Font's Name 

The f m_getf ontid routine translates a font id into its corresponding font name. 

fm_getiiaime (gfd, fontid, filename) 

The filename parameter returns a character string containing the pathname used 
to load the font represented by fontid. 

Example 

The following function gets font size, style, and name information for the font 
specified by the fid parameter; it returns this information to the calling program. 



#include <fonticon.h> 
ttinclude <starbase . c . h> 

mainO 
{ 

int gf d ; 

int fid; 

struct escapecodes esc; 

char symbol_char; 

char pathname [80] ; 



/* font manager definitions */ 

/* get starbase defs */ 

/* program "Style. c" */ 

/* file descriptor */ 

/* font id */ 
/* font-specific style information */ 

/* character desribing the font */ 

/* pathname of the font */ 



if ((gfd = gopen("/dev/crt". OUTDEV, "hp98550" , INIT)) == -1) 
exit(l) ; 

fm_load(gfd. "/usr/lib/raster/18x30/SNF/pica.8U.scf " . &f id) ; 
f m_getname (gf d . fid, pathname); 
printf("For the font in '/,s\n" , pathname); 
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fin_styleinfo(gfd, fid, &symbol_char, &esc) ; 

J _j_j! /•iimi- _ i-_n -i j_ 0/_\_ii ■i._n _t. 



printf ( 
printf ( 
printf ( 
printf ( 
printf ( 
printf ( 
printf ( 
printf ( 
printf ( 
printf ( 



The symbol_char is y,c\n" , symbol_char) ; 
The escape codes are An"); 

symbol_int : '/,d\n" , esc . symbol_int) ; 

typeface : 7,d\n" , esc . typeface) ; 

proportional: 7,d\n" , esc. proportional) ; 

hpitch: '/,d\n" , esc.hpitch); 

vheight : y,d\n" , esc . vheight) ; 

style : 7,d\n" , esc . style) ; 

boldness: y,d\n" , esc. boldness) ; 

quality: y,d\n" , esc . quality) , • 



fm_remove(gfd, fid) ; 
gclose(gfd) ; 
> /* end of main */ 



/* Remove the font 
/* Close the device 



*/ 
*/ 
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4 



Compiling FA/FM Programs 



Linking Window Libraries 

When compiling a program that calls window, fast alpha, or font manager library 
routines, link the libraries in the order shown below. You only need to link the 
libraries that the program uses. 

1. libfa.a — if the program calls any fast alpha routines, link this library 
first. 

2. libfontm.a — if the program calls any fast alpha or font management 
routines, link this library. 

3. lihdddriver . a — always link the device driver (or drivers) of the display 
on which the programs run. Not all starbase drivers support FA/FM. See 
the Starbase Device Drivers Library manual to determine which drivers 
to use. 

4. libddbyte.a or libddbit.a — if the program performs graphics to 
windows with retained rasters, and you want the raster to be maintained 
in memory, load this driver, which writes to the retained memory. If the 
program does not use windows, you do not need to link this library. 

5. libXwindow. a, libXhpll . a, libXrll . a, libXll . a — these libraries should 
be linked if the program calls X window routines or performs graphics (fast 
alpha, font manager) output to an X window. If the program does not 
use X windows, you do not need to link these libraries. 

6. libwindow . a — this library should be linked if the program calls 

HP Windows/9000 window routines or performs graphics (fast alpha, 
font manager) output to an X window. If the program does not use 
HP Windows/9000 or Xll windows, you do not need to link this library. 

7. libsbl . a — link this library if the program calls any Starbase graphics, 
fast alpha, or font manager routines. 
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8. Iibsb2 . a — link this library immediately after libsbl . a if libsbl . a was 
loaded. 



Examples 

The following examples should help clarify how the libraries are linked with the 
main program. 

A C program named xpg . c that creates and manipulates graphics windows calls 
only font manager routines, and performs star base graphics to a retained XI 1 
window on an HP 98730 display would be compiled as: 

cc xpg.c -Ifontm -ldd98730 -Iddbyte -IXwindow -Isbl -lsb2 -IXhpll -1X11 

A C program named f aprog. c that creates and manipulates graphics windows, 
calls fast alpha and font management routines, and performs graphics to a 
retained HP Windows/9000 graphics window on an HP 98700 display would be 
compiled as: 

cc f aprog. c -If a -Ifontra -ldd98700 -Iddbyte -Iwindow -Isbl -lsb2 

A C program named gpr . c that calls fast alpha and font management routines 
and performs graphics on an HP 98720 display would be compiled as: 

cc gpr.c -If a -Ifontm -ldd98720 -Isbl -lsb2 



Font and Icon Files 



/usr/lib/raster/* 

/usr/lib/raster/icons 

/usr/lib/raster/dflt/b/h/$LANG 



Contains all font directories. 

Icon definition files are stored here. 

If this file is present, it is the default 
base font (/usr/lib/raster/df It), 
(/b) for high-resolution displays (/h) 
for the language defined by the $LANG 
environment variable. 
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/usr/lib/raster/dflt/b/l/$LANG 



/usr/lib/raster/dflt/a/h/$LANG 



/usr/lib/raster/dflt/a/l/$LANG 



If this file is present, it is the default 
base font (/usr/lib/raster/df It), 
(/b) for low-resolution displays (/I) 
for the language defined by the $LANG 
environment variable. 

If this file is present, it is the default al- 
ternate font (/usr/lib/raster/df It), 
(/a) for high-resolution displays (/h) 
for the language defined by the $LANG 
environment variable. 

If this file is present, it is the default al- 
ternate font (/usr/lib/raster/df It), 
(/a) for low-resolution displays (/I) 
for the language defined by the $LANG 
environment variable. 



Note 



The actual SNF versions of these font files are in SNF subdirec- 
tories. 



Header Files 

There are two files that contain information about the fast alpha and font 
manager structures. 



/usr/include/f a . h 
/usr/include/f onticon . h 



Fast alpha constant and structure def- 
initions. 

Font constant and structure defini- 
tions. 
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Table of Contents: 
Fast Alpha/Font Manager Reference 

Manual entries are arranged alphabetically by entry name. Section number follows the entry name and 
is enclosed within parentheses. 

Entry Name(Section) name Description 

FA(3W): fa summary of fast alpha library routines 

FACLEAR(3W): faclear clear the window area specified by the given rectangle 

FACOLORS(3W): facolors set the fast alpha font foreground and background colors 

FACURS0R(3W): facursor control the displayed cursor 

FAFONTACTiVATE(3W): fafontactivate activate a fast alpha font 

FAFONTLOAD(3W): fafontload load a font into the user's font cache and prepare it for activation 

FAFONTREMOVE(3W): fafontremove remove a font from the user's font cache 

FAGETlNFO(3W): fagetitifo get information about the fast alpha environment 

FAINIT(3W): fainit prepare a fast alpha window device for output, and set up all defaults 

FARECTWRITE(3W): farectwrite fill an area of the window with the specified character 

FAROLL(3W): faroll „ roll a portion of the window 

FASETlNFO(3W): fasetinfo set information about the fast alpha environment 

FATERMINATE(3W): faierminate terminate the current fast alpha environment 

FAWRITE(3W): fawrite write a line of characters with their enhancements 

FM_ACTIVATE(3W): fm_activate make a font active 

FM_CLIPFLAG(3W): fin_clipflag set clipping flag 

FM_CLIPLIM(3W): fm_cliplim set clip limits 

FM_COLORS(3W): fm_colors set active font's foreground and background colors 

FM_FlLElNFO(3W): fm_fileinfo return the size of cells in a font file 

FM_FONTDlR(3W): fm_fontdir set character direction 

FM_GETNAME(3W): fm_getname translate font id to filename 

FM_LOAD(3W): fmjoad load a font into memory 

FM_0PT(3W): fm_opt optimize character generation if possible 

FM_RASTERlNFO(3W): fm_rasterinfo return the size of cells in a font 

FM_REMOVE(3W): fm_remove remove a font 

FM_SIXTEEN_BIT(3W): fm_sixteenj)it set sixteen bit flag .br 

FM_STR_LEN(3W): fm_str_len determine the pixel length of a character string 

FM_STYLElNFO(3W): fm_styleinto return style information about a font 

FM_WRITE(3W): fmjwrite write characters to the screen 

FONTM(3W): fontm summary of font manager library routines 
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NAME 

fa — summary of fast alpha library routines 

DISCUSSION 

The fast alpha library, /usr/lib/libfa.a, provides high-performance alpha (textual) capabilities 
with graphics windows and bitmapped displays. Fast alpha assumes uniform width fonts and 
provides a row and column interface. Fast alpha also implements the concepts of a cursor and 
display enhancements. 

All fast alpha library calls require a gopen(3G) file descriptor that may be for a bitmapped 
display device or for a graphics window. 

Programs that call fast alpha routines must link in the fast alpha library (-Ifa). In addition, pro- 
grams that call fast alpha library routines must also link in the font manager (-Ifontm) and Star- 
base (-Isbl -lsb2) libraries. 

The header file /usr/include/fa.h contains structure and constant definitions used by fast alpha 
library routines. Programs should attempt to use these definitions when calling fast alpha 
library routines. 

Fast alpha library routines are summarized below. For more information on each routine, con- 
sult its reference page. 

faclear(3W) Clear a window area specified by a fa_rectangle structure, defined 

in fa.h. 

facolors(3W) Set the font foreground and background colors for the currently 

activated fast alpha font. 

facursor(3W) Position and enable/disable the fast alpha cursor. 

fafontactivate(3W) Activate a fast alpha font. 

fafontload(3W) Load a font file into the font cache and activate it. 

fafontremove(3W) Remove a font from the font cache. 

fagetinfo(3W) Get information about the current fast alpha environment. 

Return this information in an fainfo structure, defined in fa.h. 

fainit(3W) Prepare a fast alpha window for output; set the window's fast 

alpha environment to default values. 

farectwrite(3W) Fill an area of a window, defined by an fa_rectangle structure 

from fa.h, with a character. 

faroll(3W) Roll (scroll) a portion of a window. The area to roll is defined by 

an fa_rectangle structure from fa.h. 

fasetinfo(3W) Set information about the fast alpha environment. Information is 

set from an fainfo structure, defined in fa.h. 

faterminate(3W) Terminate the current fast alpha environment, which was initial- 

ized via fainit{3W). 

fawrite(3W) Write characters in the active font. 

EXAMPLES 

The following example compiles a program, named fawinprog.c, that calls fast alpha routines to 
display text in graphics windows. The program will run on a Series 300 high-resolution display 
using retained graphics windows (thus the -ldd300h and -Iddbyte options). 

cc fawinprog.c -Ifa —Ifontm — IddSOOh -Iddbyte -Iwindow -Isbl -lsb2 
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SEE ALSO 

windows(l),fontm(3W),gopen(3G),window(3W). 
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NAME 

faclear - clear the window area specified by the given rectangle 

SYNOPSIS 

#include <fa.h> 

int faclear(gfd,reserved,rp); 

int gfd; 

int reserved; 

struct fa_rectangle *rp; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

reserved this field is reserved for future expansion 

rp is the pointer to the data structure which describes the rectangle to be cleared. 

DISCUSSION 

This routine clears the area bounded by the rectangle pointed to by rp. 

By default, this routine clears the screen immediately. It is possible to get better performance 
by buffering clear operations and updating the screen after several operations are buffered. See 
fasetinfo{3W) and the fa.h header file for information on how to buffer-up writes, as opposed to 
having them occur when this routine is called. 

SEE ALSO 

fagetinfo(3W). 

DIAGNOSTICS 

A value of —1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

facolors - set the fast alpha font foreground and background colors 

SYNOPSIS 

#include <fa.h> 

int facolors(gfd,foreground,background); 

int gfd; 

int foreground,background; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

foreground is the new foreground color. 
background is the new background color. 

DISCUSSION 

Sets the foreground and background colors of the activated font for all further fast alpha opera- 
tions. These colors are indices into the system color map. Valid values are: and 1 for mono- 
chromatic displays, to 15 for 4-plane color, and to 255 for 16-plane color. The color table 
index is assumed to be black and the index 1 is assumed to be white. Note, that if colormode 
is not set to FACOLOR, the system will ignore any color changes; see fagetinfo and fasetinfo. 

Color values outside the acceptable range (i.e., or 1 for monochrome, to 15 for 4-plane 
color, and to 255 for 8-plane color) will default to 1 (white). 

SEE ALSO 

fasetinfo(3W), fagetinfo(3W). 

DIAGNOSTICS 

A value of -1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

facursor — control the displayed cursor 

SYNOPSIS 

#include <fa.h> 

int facursor(gfd,column,line,cflag); 

int gfd; 

int coluinn,line; 

int cflag; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

column indicates the alpha column at which to do the operation. 

line indicates the alpha line at which to do the operation. 

cflag if cflag is TRUE, the cursor is made visible. If FALSE, the cursor is made 

invisible (if possible). If column and line are valid coordinates, the cursor (visi- 
ble or invisible) is positioned accordingly. If either is invalid (i.e. —1), the cur- 
sor position is not affected. FACURSORNOMOVE is defined as -1 in 
/usr/include/fa.h to provide a mnemonic for specifying invalid values. This 
is useful for updating the cursor position without actually moving it. 

DISCUSSION 

This routine allows the user to position and turn on and off the cursor. It also allows the user 
to "store" or change a cursor position without moving its physical position until a later opera- 
tion. 

The cursor size is the character cell size of a 1-byte character even if a HP-15 (2-byte) font is 
used. The 2-byte characters are twice as wide as the 1-byte characters. Thus they take up two 
columns. 

By default, fast alpha "writes" update the screen immediately. It is possible to get better per- 
formance by buffering writes and updating the screen after the writes are buffered. See 
fasetinfo(3YJ) and the fa.h header file for information on how to buffer-up writes, as opposed to 
having them occur when this routine is called. 

SEE ALSO 

fawrite(3W). 

DIAGNOSTICS 

A value of —1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

fafontactivate - activate a fast alpha font 

SYNOPSIS 

int fafontactivate(gfd,fontid); 
int gfd, fontid; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

fontid is the id of the font to activate. 

DISCUSSION 

This routine sets the specified font as the currently active font for the current window device. 
The specified font must be one that was previously made available by fafontload or fmjoad. 

SEE ALSO 

fafontload(3W), fm_load(3W). 

DIAGNOSTICS 

A value of -1 is returned if gfd or fontid is invalid or a call to fainit was never executed on this 
gfd. See errno{2) for further information. 
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NAME 

fafontload - load a font into the user's font cache and prepare it for activation 

SYNOPSIS 

int fafontload(gfd,path); 
int gfd; 
char *path; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

path is the path name of the font to be loaded. 

DISCUSSION 

This routine loads a font into the user's cache of available fonts. Any of these fonts are ready to 
be activated as needed. A system-wide unique font id is returned unless gfd or path are invalid, 
in which case -1 is returned. Like fm_fontload{3W), fafontload automatically makes the font 
active when it is loaded. Note that font manager and fast alpha font ids are the same and can 
be used with both fast alpha and font manager routines. 

This routine will try to optimize the font if the font file header block indicates to do so. 

SEE ALSO 

fafontremove(3W), fafontactivate(3W), fm_load(3W). 

DIAGNOSTICS 

A value of —1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 

WARNING 

When using either rectangular fonts (pixelformat = 1) or HP-15 fonts (pixelformat — 2) with a 
low resolution display and retained rasters, the portion that gets obscured will lose every other 
pixel of information. Also, 2-byte characters that are written to the obscured portion of the ras- 
ter will appear twice the size they should be when the area is unobscured. 
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NAME 

fafontremove — remove a font from the user's font cache 

SYNOPSIS 

int fafontremove(gfd,fontid); 
int gfd,fontid; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

fontid a unique system id assigned to a font when the font is loaded with fafontload. 

DISCUSSION 

This routine deletes the font from the user's font cache. If this font was the currently active 
font, an error will occur if further fast alpha operations are attempted without first activating 
another font. 

SEE ALSO 

fafontload(3W), faterminate(3W). 

DIAGNOSTICS 

A value —1 is returned if gfd or fontid is invalid or a call to fainit was never executed on this 
gfd. See errno{2) for further information. 
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NAME 

fagetinfo — get information about the fast alpha environment 

SYNOPSIS 

#include <fa.h> 

int fagetinfo(gfd,fainfoptr) 

int gfd; 

struct fainfo *fainfoptr; 

DESCRIPTION 

gfd is an integer file descriptor for a gopened device interface. 

fainfoptr is a pointer to the structure defined as follows: 

struct fainfo { 

struct fa_rectangle size; 

int capabilities; 

int enhancements; 

int defaultenhancements; 

int cursor; 

int fontcellheight; 

int fontcellwidth; 

int foregroundplanes; 

int backgroundplanes; 

int clearbeforewrite; 

int colormode; 

int makecurrent; 

}; 

Descriptions of each field in this structure are: 

size a structure with one corner set to [0, 0] and the other set to [number of 
columns, number of lines]. (See Fast Alpha Rectangles in the Fast 
Alpha/Font Manager Programmer's Manual.) 

capabilities 

an integer assigned a value from a list in the header file. The contents 
of capabilities may be used by a program to detect what additional 
capabilities are available on a particular device. Currently defined capa- 
bilities are: 

FAWINDOW - Device is a window or bitmapped graphics device. 
More information may be obtained by calls to other window system 
routines. 

enhancements 

is assigned to the bitwise ORing of the various enhancement bits (see 
farectwrite) which are supported by the particular device. 

defaultenliancements 

is initially set to a value which optimizes the performance of the win- 
dow system. It is used by fawrite and faroll. It is a read/write field in 
that it can be changed by calling fasetinfo. 

cursor cursor is TRUE if the cursor may be physically removed from the win- 
dow device and is FALSE otherwise. 

fontcellheigtit, fontcellwidth 

indicates the size (in pixels) of the fontcell of 1-byte characters. The 
2-byte characters are twice as wide. The cursor size and the column 
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addressing are based on the size of 1-byte characters. 

clearbeforewrite 

is TRUE if the fast alpha library routine is to clear the background of 
the area to be written to before the characters are written, clear- 
beforewrite set to FALSE indicates that the user is responsible for clear- 
ing and desires no background clearing by the library routine, clear- 
beforewrite defaults to TRUE, clearbeforewrite currently pertains only to 
FACOLOR mode; see colormode, below. 

foregroundplanes, backgroundplanes 

specifies the number of memory planes available for controlling the 
foreground and background colors respectively. A value of 1 in fore- 
groundplanes and 1 in backgroundplanes indicates a monochrome sys- 
tem. Values > 1 indicate a color system. 

colormode 

when set to FAWONB (white on black - which is the default) indicates 
that the user is not using the color options. This allows the fast alpha 
routines to run somewhat faster than when color is incorporated. 
When colormode is set to FACOLOR, the additional system operations 
needed to incorporate color are performed. A third option is to set 
colormode to FABONW (black on white) which inverses the previous 
monochromatic option, FAWONB; see facolors. 

makecurrent 

setting this field to bitwise ORing of values specified in the header file 
(/usr/include/fa.h) controls the appearance of fast alpha operations 
on the screen. For performance reasons, the user may choose to 
suppress the updating of the screen until several operations are queued 
up. When updating is desired, the user signals the fast alpha environ- 
ment to update the screen by setting the makecurrent value to MCAL- 
WAYS (make current always). Queued up operations will show up on 
the screen at this time. The default value is MC ALWAYS, that is, 
update the screen upon every fast alpha operation. 

DISCUSSION 

This routine is used to find out information about the window device, or to get currently set 
values in the fast alpha environment. Display information might include the size of the win- 
dow device and the video attributes it supports. Fast alpha environment values might include 
the size of the current window device or the size of the currently active font. 

fagetinfo is the counterpart of fasetinfo. It is used for inquiring the values of parameters in a fast 
alpha environment. 

SEE ALSO 

fasetinfo(3W), fainit(3W). 

DIAGNOSTICS 

A value of - 1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

fainit — prepare a fast alpha window device for output, and set up all defaults 

SYNOPSIS 

#include <fa.h> 
int fainit(gfd,driver); 
int gfd; 
int driver; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

driver indicates the driver to be used for all subsequent fast alpha calls, i.e., indicates 

a particular display device. See /usr/include/fa.h for all valid driver names. 
The value FAWINDOW should be used for HP Windows/9000 Fast Alpha 
Library. 

DISCUSSION 

This routine is used to set up the default values the fast alpha environment will use for future 
fast alpha library calls. It assumes that a gopen{3S) has actually been performed, and that the 
returned file descriptor is supplied as gfd. 

These variables remain in effect until font or color changing library routines are invoked or until 
an faterminate is encountered. Calls to fasetinfo with proper parameters can alter the state set 
up by fainit. 

SEE ALSO 

faterminate(3W), fasetinfo(3W). 

DIAGNOSTICS 

A value of —1 is returned if gfd or driver is invalid or if fainit otherwise fails. See errno{2) for 
further information. 
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NAME 

farectwrite — fill an area of the window with the specified character 

SYNOPSIS 

#include <fa.h> 

int farectwrite(gfd,character,enhancement,rp); 

int gfd; 

int character; 

int enhancement; 

struct fa_rectangle *rp; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface 

character is the character to be used to fill the given rectangle area. Only 1-byte character 

codes may be used; 2-byte characters cannot be used for the rectangle fill. 

enhancement is the enhancement to be used in the rectangle fill operation. 

rp is the pointer to the data structure which describes the rectangle to be filled. 

DISCUSSION 

This routine writes what is defined by character and enhancement to all positions in the area 
bounded by the rectangle pointed to by rp. 

Legal enhancements are: 

FAOFF 

FAINVERSE 

FAUNDERLINE 

The set of enhancements supported by a particular device should first be determined by calling 
fagetinfo. Legal enhancement values are formed from the bitwise ORing of the desired enhance- 
ments which are supported by the particular device. If no enhancement is given, i.e., enhance- 
ment is (zero), defaultenhancements, from fasetinfo, is used. The user may indicate that no 
enhancements are desired by using FAOFF for the enhancement. 

By default, fast alpha "writes" update the screen immediately. It is possible to get better per- 
formance by buffering writes and updating the screen after the writes are buffered. See 
fasetinfo {3W) and the fa.h header file for information on how to buffer-up writes, as opposed to 
having them occur when this routine is called. 

SEE ALSO 

fagetinfo(3W), fasetinfo(3W). 

DIAGNOSTICS 

A value of -1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

faroll — roll a portion of the window 

SYNOPSIS 

#include <fa.h> 

int faroll(gfd,how,howfar,rp); 

int gfd; 

int how; 

int howfar; 

struct fa_rectangle *rp; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

how determines the direction the window is to be rolled. Valid directions are: 

FAROLLUP 'u' 

FAROLLDOWN 'd' 

FAROLLEFT T 
FAROLLRIGHT'r' 

howfar 

the window is rolled howfar character units in the direction given by how. 

rp is a pointer to the data structure which describes the rectangle to be filled. 

DISCUSSION 

This routine rolls the area bounded by the rectangle described by rp. 

Any enhancements present are also rolled. 

The area "uncovered" by the roll is filled as if farectwrite were called given the space character 
and defaultenhancements as parameters, see farectwrite. This routine does not affect the cursor. 

When 2-byte characters are displayed and the rolling is done, some 2-byte characters may be 
split into two parts, or half of the character may be erased. This is because the rolling is done 
based on columns, and each 2-byte character takes up two columns. 

By default, the fast alpha rolling operation updates the screen immediately. It is possible to get 
better performance by buffering roll operations and updating the screen after the roll operations 
are buffered. See fasetinfo{3W) and the fa.h header file for information on how to buffer-up 
rolls, as opposed to having them occur when this routine is called. 

SEE ALSO 

farectwrite(3W). 

DIAGNOSTICS 

A value of — 1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

fasetinfo - set information about the fast alpha environment 

SYNOPSIS 

#include <fa.h> 

int fasetinfo(gfd,fainfoptr); 

int gfd; 

struct fainfo *fainfoptr; 

DESCRIPTION 

gfd is an integer file descriptor for a gopened device interface. 

fainfoptr is a pointer to the structure defined as follows: 

struct fainfo { 

struct fa_rectangle size; 

int capabilities; 

int enhancements; 

int defaultenhancements; 

int cursor; 

int fontcellheight; 

int fontcellwidth; 

int foregroundplanes; 

int backgroundplanes; 

int clearbeforewrite; 

int colormode; 

int makecurrent; 

}; 

Descriptions of each field in this structure are: 

size a structure with one corner set to [0, 0] and the other set to [number of 
columns, number of lines]. (See Fast Alpha Rectangles in the Fast 
Alpha/Font Manager Programmer's Manual.) 

This parameter cannot be set by fasetinfo. It is used to obtain informa- 
tion via fagetinfo . 

capabilities 

an integer assigned a value from a list in the header file. The contents 
of capabilities may be used by a program to detect what additional 
capabilities are available on a particular device. Currently defined capa- 
bilities are: 

FAWINDOW — Device is a window or bitmapped graphics device. 
More information may be obtained by calls to other window system 
routines. 

This parameter cannot be set by fasetinfo. It is used to obtain informa- 
tion via fagetinfo . 

enhancements 

is assigned to the bitwise ORing of the various enhancement bits (see 
farectwrite) which are supported by the particular device. 

defaultenhancements 

is initially set to a value which optimizes the performance of the win- 
dow system. It is used by fawrite and faroll. It is a read/write field in 
that it can be changed by calling fasetinfo. 
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cursor cursor is TRUE if the cursor may be physically removed from the win- 
dow device and is FALSE otherwise. 

This parameter cannot be set by fasetinfo . It is used to obtain informa- 
tion via fagetinfo. 

fontcellheight, fontcellwidth 

indicates the size (in pixels) of the 1-byte character fontcell. The 2-byte 
characters are twice as wide. 

This parameter cannot be set by fasetinfo . It is used to obtain informa- 
tion via fagetinfo . 

clearbeforewrite 

is TRUE if the fast alpha library routine clears the background of the 
area to be written to before the characters are written, clearbeforewrite 
set to FALSE indicates that the user is responsible for clearing and 
desires no background clearing by the library routine, clearbeforewrite 
defaults to TRUE, clearbeforewrite currently pertains only to FACOLOR 
mode; see colormode, below. 

foregroundplanes, backgroundplanes 

specifies the number of memory planes available for controlling the 
foreground and background colors respectively. A value of 1 in fore- 
groundplanes and 1 in backgroundplanes indicates a monochrome sys- 
tem. Values > 1 indicate a color system. 

This parameter cannot be set by fasetinfo . It is used to obtain informa- 
tion via fagetinfo . 

colormode 

when set to FAWONB (white on black — which is the default) indicates 
that the user is not using the color options. This allows the fast alpha 
routines to run somewhat faster than when color is incorporated. 
When colormode is set to FACOLOR, the additional system operations 
needed to incorporate color are performed. A third option is to set 
colormode to FABONW (black on white) that inverses the previous 
monochromatic option, FAWONB; see facolors. 

makecurrent 

setting this field to bitwise ORing of values specified in the header file 
(/usr/ihclude/fa.h) controls the appearance of fast alpha operations 
on the screen. For performance reasons, the user may choose to 
suppress the updating of the screen until several operations are queued 
up. When updating is desired, the user signals the fast alpha environ- 
ment to update the screen by setting the makecurrent value to MCAL- 
WAYS (make current always). Queued up operations will show up on 
the screen at this time. The default value is MCALWAYS, that is, 
update the screen upon every fast alpha operation. 

DISCUSSION 

This routine is used to set information regarding the window device, or to set new values in the 
fast alpha environment. Parameters which are user-settable include: defaultenhancements, clear- 
beforewrite, makecurrent, and colormode. 

fasetinfo is the counterpart of fagetinfo. It is used for changing certain parameters of a fast alpha 
environment. 
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SEE ALSO 

fagetinfo(3W). 

DIAGNOSTICS 

A value of —1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

faterminate — terminate the current fast alpha environment 

SYNOPSIS 

int faterminate(gfd) 
int gfd; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

DISCUSSION 

This routine is the opposite of fainit. It frees up all system resources acquired during fainit and 
discards all fast alpha state information associated with the current file descriptor. 

faterminate has no effect on the currently active font. It remains active unless a fafontremove on 
the active font was encountered prior to faterminate. 

SEE ALSO 

faimt(3w), fafontremove(3w), fafontactivate(3w). 

DIAGNOSTICS 

A value of -1 is returned if gfdf is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 
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NAME 

fawrite - write a line of characters with their enhancements 

SYNOPSIS 

#include <fa.h> 

int fawrite(gfd,column,line,charbuf,ebuf,strlen); 

int gfd; 

int column, line; 

char *charbuf; 

ENH *ebuf; 

int strlen; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

column indicates the alpha column at which to start the operation. 

line indicates the alpha line at which to do the operation. 

charbuf points to the characters to write (a null character does not terminate this 

string!) 

ebuf points to the corresponding enhancements for each character (i.e. the third 

character in charbuf receives the enhancement of the third element of ebuf). 
ebuf may be NULL signifying that no enhancements are indicated. In this case, 
the defaultenhancements (from fasetinfo) is used. The valid values for ebuf are 
taken from the set described in farectwrite. Enhancement values are the bitwise 
ORing of the values supported by the particular device. 

Previously enhanced character positions lose their enhancement when 
overwritten by a non-enhanced character (i.e. ebuf is NULL). 

strlen is the number of bytes to write. If the string contains 2-byte characters, each 

2-byte character is counted as two bytes. 

DISCUSSION 

This library call writes strlen characters on the window device starting at the locations described 
by column and line. 

fawrite does not affect the cursor position. 

Attempts to use fawrite for wrapping or scrolling may produce undesired results. 

The following processing is done only when the current active font is a HP- 15 (2-byte) charac- 
ter font: 

* If the string to be output contains an undefined 2-byte character, the 2-byte galley character 
is output instead of the undefined character. 

* If the string contains an illegal 2-byte character, it outputs the two 1-byte characters that 
correspond to the code values of the illegal 2-byte character. 

* If the last code in the string is the first code of a 2-byte character, it outputs the 1-byte 
character that corresponds to the code value. 

By default, fast alpha "writes" update the screen immediately. It is possible to get better per- 
formance by buffering writes and updating the screen after the writes are buffered. See 
fasetinfo {3W) and the fa.h header file for information on how to buffer-up writes, as opposed to 
having them occur when this routine is called. 

SEE ALSO 

fasetinfo(3W), farectwrite(3W), facursor(3W). 
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DIAGNOSTICS 

A value of — 1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See 
errno{2) for further information. 

BUGS 

If a rectangular font (pixelformat = 1) or a HP-15 (2-byte) font (pixelformat = 2) is used on a 
low-resolution display with retained rasters, every other rectangular pixel will be lost when an 
area is obscured. Also, 2-byte characters that are written to obscured area will be twice as big 
as they should be when the area is displayed. 
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NAME 

fm_activate — make a font active 

SYNOPSIS 

int fm_activate(gfd,fontid); 
int gfd, fontid; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

fontid is the id of the font to activate. 

DISCUSSION 

Sets the specified raster font as the currently active font for the gopened device. All alpha out- 
put done by fmjwrite after this point will use this font. 

fmjoad activates its font, so calling fm_activate is often not needed. 

SEE ALSO 

fm_load(3W),fm_write(3W). 

DIAGNOSTICS 

A —1 is returned if gfd or fontid is not valid; otherwise, is returned. See errno{2) for further 
information. 
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NAME 

fm_clipflag - set clipping flag 

SYNOPSIS 

int fm_clipflag(gfd,flag); 
int gfd; 
int flag; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

flag flag to indicate whether clipping is on (1) or off (0). 

DISCUSSION 

This routine enables clipping for raster alpha output as indicated by flag. 

DEFAULTS 

Clipping flag is off (0). 

SEE ALSO 

fm_cliplim(3W). 

DIAGNOSTICS 

A —1 is returned if gfd is not valid. If clipping is not enabled, it is possible to write outside of 
the window boundaries, randomly change other user variables, destroy the executing program 
itself, etc. It is recommended that clipping always be enabled for debugging. See errno{2) for 
more information. 
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NAME 

fm_cliplim — set clip limits 

SYNOPSIS 

int fm_cliplim (gfd,X/y,width,height); 

int gfd; 

int x,y; 

int width,height; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

x,y are the n\inimum (upper,left) x,y clip boundary, in pixels, relative to the win- 

dow described by gfd. 

width,height are the size, in pixels, of the rectangle to clip. 

DISCUSSION 

This routine sets the clipping rectangle for raster alpha output as indicated by x, y, width, and 
height. 

SEE ALSO 

fm_clipflag(3W). 

DIAGNOSTICS 

Returns —1 if gfd is not valid; otherwise, is returned. See errno{2) for more information. 
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NAME 

fm_colors - set active font's foreground and background colors 

SYNOPSIS 

int fm_colors(gfd,foreground,background); 
int gfd,foreground,background; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

foreground is the new foreground color; valid values are device dependent. 
background is the new background color; valid values are device dependent. 

DISCUSSION 

Sets the foreground and background colors as would be used by fmjwrite. 

Though the colors are device dependent, it is generally safe to assume that is black (off) and 1 
is white (on). 

SEE ALSO 

fm_write(3w). 

DIAGNOSTICS 

Returns -1 if gfd is not valid or the color is out of range. See errno{2) for more information. 
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NAME 

fm_fileinfo — return the size of cells in a font file 

SYNOPSIS 

int fm_fileinfo(path,width,height,baseline); 

char *path; 

int *width,*height,*baseline; 

DESCRIPTION 

path is the path name to the font file. 

width width of 1-byte character cells in the font. 

height height of character cells in the font. 

baseline baseline of character cells in the font; distance from the bottom of the character 

cell to the bottom of a typical character image which does not have a des- 
cender. 

DISCUSSION 

For the designated font file, the width, height and baseline for the character cells are returned. 
The returned cell width is the cell width of the 1-byte characters, even if the designated font is 
a HP-15 (2-byte) character font that includes 1- and 2-byte characters. 2-byte characters are 
twice as wide as the returned width. The baseline is also returned for the 1-byte character cell, 
regardless of whether a character is one or two bytes, and the baseline of the 2-byte characters 
is equal to the descender line of 1 /2-byte characters. 

For proportional fonts, width and height are the maximums, respectively, of the widths and 
heights of the character cells in the font file. The baseline is sometimes useful for lining up 
characters in different-sized fonts. 

This library call is useful for determining what size to create a window that will contain fixed 
text. 

SEE ALSO 

fm_rasterinfo(3W),fm_load(3W). 

DIAGNOSTICS 

A -1 is returned if path does not designate a font file; otherwise, is returned. See errno{2) for 
more information. 
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NAME 

fm_fontdir — set character direction 

SYNOPSIS 

int fm_fontdir(gfd,direction); 
int gfd, direction; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

direction Direction for character printing, valid values are: 

'u' - v^rite characters upward 

'd' - write characters downward 

T - write characters to the left 

'r' - write characters to the right 

DISCUSSION 

Sets the character printing direction as defined by direction. This write direction remains in 
effect until a different font is activated. 

SEE ALSO 

fm_write(3W). 

DIAGNOSTICS 

Returns —1 if gfd is not valid or direction is out of range; otherwise, is returned. See errno{2) 
for more information. 
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NAME 

fm_getname — translate font id to filename 

SYNOPSIS 

int fm_getname(gfd,fontid,filename); 
int gfd,fontid; 
char *filename; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

fontid is the font id as returned by fmjoad. 

filename array of characters to contain font filename. 

DISCUSSION 

The filename that was given to fmjoad to create fontid is returned in filename. 

It is the responsibility of the caller to assure that filename points to a area large enough to con- 
tain the entire filename. 

SEE ALSO 

fm_load(3W). 

DIAGNOSTICS 

A -1 is returned if gfd or fontid is not valid; otherwise, is returned. See errno{2) for more 
information. 
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NAME 

fm_load — load a font into memory 

SYNOPSIS 

int fm_load{gfd,path,fontid); 
int gfd; 
char *path; 
int *fontid; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

path is the path name of the font file to be loaded. 

fontid is the system wide font id returned upon successful load. 

DISCUSSION 

This routine loads a font file and updates the font manager's tables appropriately. The desig- 
nated font is made the active font, as if fm_actwate was called. Hence, certain graphics parame- 
ters may be reset; see fm_activate for details. If the optimize bit is set in the font file fm_opt will 
be called to optimize the font. A system-wide unique font identifier is returned. 

Note that font ids (and hence fonts) are associated with a (gfd,process-id) pair. In particular, if 
a font has been loaded using a gfd for one device, fm_write cannot be called with that font id 
and a different gfd. Both the file descriptor and process id must match to use a font. 

Note that fmjoad and fm_remove act much like open{2) and close{2), in that every font loaded 
by fmjoad should be released by a call to fm_remove. If a font is loaded twice by separate calls 
to fmjoad, two calls to fm_remove should be performed to release the font. If gfd or path is 
invalid, —1 is returned by fmjoad. If the font is already loaded a new fontid will be returned. 
A —1 is also returned if format of the font file is incompatible with the device architecture. 

SEE ALSO 

fm_remove(3W),fm_activate(3W),fm_opt(3W). 

DIAGNOSTICS 

A return of —1 indicates failure; otherwise, is returned. See errno(2) for more information. 

WARNING 

If a rectangular font (pixelformat = 1) or a HP-15 (2-byte) font (pixelformat = 2) is used on a 
low resolution display with retained rasters, every other rectangular pixel will be lost when an 
area is obscured. Also 2-byte characters that are written to an obscured area will be twice as 
big as they should be when the area is unobscured. 
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NAME 

fm_opt — optimize character generation if possible 

SYNOPSIS 

int fm_opt(gfd,optmode); 
int gfd, optmode; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

optmode optimization mode, where means unoptimize and 1 means attempt to optim- 

ize. 

DISCUSSION 

This routine causes the device driver to use any special hardware and/or routines it has avail- 
able for displaying characters for the active font. Not all fonts are optimizable. This is com- 
pletely device dependent; some devices may not support such a thing as optimization so all 
character generation may be the same speed regardless. 

If optimization is unsuccessful, it may be due to lack of internal table space. It may help to 
release an optimized font and try again. 

If the optimize bit is set in the font file, fmjoad will call fm_opt, thereby attempting to optimize 
the font as it is loaded. 

Only the 1-byte character portion of a HP-15 (2-byte) font will be optimized. The 2-byte char- 
acter portion will remain bit/pixel in memory and will continue to be expanded to byte/pixel at 
display time. 

SEE ALSO 

fm_load(3W). 

DIAGNOSTICS 

This routine will return —1 if the operation was unsuccessful (or not possible at this time due to 
limited resources) or if there is no active font; otherwise, is returned. See errno{l) for more 
information. 
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NAME 

fm_rasterinfo — return the size of cells in a font 

SYNOPSIS 

int fm_rasterinfo(gfd,fontid,width,height,baseline); 

int gfd,fontid; 

int *width,*height,*baseline; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

fontid font id as returned by fmjoad. 

width width of 1-byte character cells in the font. 

height height of character cells in the font. 

baseline baseline of character cells in the font. 

DISCUSSION 

For the designated font, the width, height and baseline for the character cells are returned. The 
returned cell width is the width of 1-byte characters, even if the designated font is a HP-15 (2- 
byte) font that includes both 1- and 2-byte characters. The 2-byte characters are twice as wide 
as the 1-byte characters. The returned value for baseline is for the 1-byte character cell. The 
baseline of the 2-byte characters is equal to the descender line of 1/2-byte characters. 

This library call is useful for determining what size to create a window that will contain fixed 
text. 

For proportional fonts, width and height are the maximums, respectively, of the widths and 
heights of the character cells in the font. The baseline is sometimes useful for lining up charac- 
ters in different-sized fonts. 

SEE ALSO 

The "Font Manager" chapter of the Fast Alpha/Font Manager Programmer's Manual and the fol- 
lowing reference pages: fm_fileinfo(3W),fm_load(3W). 

DIAGNOSTICS 

A —1 is returned if gfd or fontid is not valid; otherwise, is returned. See errno(2) for more 
information. 
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NAME 

fm_remove — remove a font 

SYNOPSIS 

int fm_remove(gfd,fontid); 
int gfd,fontid; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

fontid is the id of font to be removed. 

DISCUSSION 

This routine deletes the font and makes it unavailable for further use by the user. All fonts 
should be removed via fmjremove calls before gclose is called. 

SEE ALSO 

fm_load(3W). 

DIAGNOSTICS 

A -1 is returned if gfd is invalid or fontid is not valid for this process/ window^; otherwise, is 
returned. See errno{2) for more information. 
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NAME 

fm_sixteen_bit - set sixteen bit flag 

SYNOPSIS 

int fm_sixteen_bit(gfd,flag); 
int gfd; 
int flag; 

DESCRIPTION 

gfd is an integer file desciptor for an gopened device interface. 

flag flag to indicate whether sixteen bit mode is on (1) or off (0). 

DISCUSSION 

This routine enables sixteen bit mode for raster alph output as indicated by flag. 

DEFAULTS 

Sixteen bit mode is off (0). 

SEE ALSO 

XDrawString(3X). 

DIAGNOSTICS 

Sixteen bit mode allows for standard MIT Xll 16 bit raster fonts to be displayed. MIT Xll 16 
bit raster fonts are not HP-15 fonts. 
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NAME 

fm_str_len - determine the pixel length of a character string 

SYNOPSIS 

int fm_str_len(gfd,str,strlen); 
int gfd; 
char *str; 
int strlen; 

DESCRIPTION 

gfd is an integer file descriptor for a gopened device interface. 

str is the string for which the length is to be determined. 

strlen is the length of str in bytes. 

DISCUSSION 

The return value of this function is the length, in pixels, of a character string along the current 
character direction of the active font for this process. For example, this could be used to center 
text in a proportionately spaced font. 

Note that str is not null-terminated; instead, strlen is used to determine its length. Each 2-byte 
character is treated as two bytes. 

The following processing is done only when the active font is a HP- 15 (2-byte) character font: 

* If the string contains an undefined 2-byte character, the cell size of the 2-byte galley char- 
acter is used. 

* If the string contains an illegal 2-byte character, the illegal character is treated as the two 
1-byte characters that correspond to the two codes that compose the illegal 2-byte character ( 
code. 

* If the last code of the string is the first code of a 2-byte character, the character is treated as 
the 1-byte character that corresponds to the code value. 

SEE ALSO 

fm_write(3W). 

DIAGNOSTICS 

A —1 is returned if gfd is not valid; otherwise, is returned. See errno{2) for more information. 
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NAME 

fm_styleinto — return style information about a font 

SYNOPSIS 

#include <fonticon.h> 

int fm_styleinfo(gfd,fontid,symbol_char,escapecodes); 

int gfd; 

int fontid; 

char *symbol_char; 

struct escapecodes *escapecodes; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

fontid is the font id as returned by fmjoad. 

symbol_char character describing font (e.g. 'U'). 

escapecodes is a structure containing font information, see /usr/include/fonticon.h. 

DISCUSSION 

A font is sometimes designated by the (symbol_int, symboLchar) pair, especially in escape 
sequences (see also termO documentation). For example, 8U is an eight-bit Roman font, OL is a 
line drawing font, OM is a math symbol font, etc. 

SEE ALSO 

fm_rasterinfo(3W),fm_load(3W). 

DIAGNOSTICS 

A —1 is returned if fontid or gfd is not valid; otherwise, is returned. See errno{2) for more 
information. 
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NAME 

fm_ write — write characters to the screen 

SYNOPSIS 

int fm_write(gfd,X/y/Str,strlen,dump,colormode); 

int gfd,x,y; 

char *str; 

int strlen,dump,colorinode; 

DESCRIPTION 

gfd is an integer file descriptor for an gopened device interface. 

x,y location (upper left) to begin writing characters. 

str character string to be output. 

strlen is the length of str in bytes. 

dump is a boolean indicator: update the screen immediately (TRUE), let the system 

imposed buffering take care of the visual update (FALSE). 

colormode is a boolean indicator: use the colors from fm_colors (TRUE). 

DISCUSSION 

If colormode is not enabled, the string is written using the current values of drawing mode and 
write enable mask for file descriptor gfd; the value of the background color index has no effect. 
Neither the drawing mode, the write enable mask, nor the background color index is modified 

by fm_write . 

If colormode is enabled, the string is written with the foreground and background colors esta- 
blished by fm_colors. Neither the drawing mode, the write enable mask, nor the background 
color index has any effect on the result. Neither the drawing mode nor the background color 
index is modified by fm_write . A side effect of fmjwrite (in colormode) is that all planes are 
enabled for writing. 

The string str is not null-terminated, the parameter strlen determines how many bytes are writ- 
ten. 

The following processing is done only when the current active font is a HP- 15 (2-byte) charac- 
ter font: 

* If the string to be output contains an undefined 2-byte character, the 2-byte galley character 
is output instead of the undefined character. 

* If the string contains an illegal 2-byte character, the two 1-byte characters that correspond 
to the codes of the illegal 2-byte character are output. 

* If the last code of the string is the first code of a 2-byte character, the 1-byte character that 
corresponds to the code value is output. 

SEE ALSO 

fm_colors(3W),fm_load(3W),write_enable(3G),drawing_mode(3G), background. color_index(3G). 

DIAGNOSTICS 

A -1 is returned if gfd is not valid; otherwise, is returned. See errno(l) for more information. 

BUGS 

If a rectangular font (pixelformat = 1) or a HP-15 (2-byte) font (pixelformat — 2) is used on a 
low resolution display with retained rasters, every other rectangular pixel will be lost when an 
area is obscured. Also, 2-byte characters that are written to the obscured area will be twice as 
big as they should be when the area is unobscured. 
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NAME 

fontm — summary of font manager library routines 

DISCUSSION 

The font manager library, /usr/lib/libfoiitm.a, provides a high-performance alpha (textual) 
interface to graphics windows and bitmapped displays. The font manager can handle different 
sizes of fonts and provides an x,y pixel interface (as opposed to the row and column interface of 
fast alpha). 

All font manager library calls require a file descriptor from gopen(3G) which may be that of a 
bitmapped display device or of a graphics window. 

Programs that call font manager routines must link in the font manager (-Ifontm) and Starbase 
(-Isbl -Isb2) libraries. 

The header file /usr/include/fonticon.h contains type and constant definitions used by font 
manager routines. Programs should use these definitions when calling font manager library 
routines. 

Font manager library routines are summarized below. For more information on each routine, 
consult its reference page. 

fm_activate(3W) Make a loaded font the active font. 

fm_clipflag(3W) Set clipping flag. This enables or disables the ability to write out- 

side a window's boundaries. 

fm_cliplim(3W) Set the clip limits; that is, define the area of a window in which 

clipping pertains. 

fm_colors(3W) Set the active font's foreground and background colors. 

fm_fileinfo(3W) Given the path name of a font file, this routine returns size infor- 

mation (i.e., pixel width, height, and baseline) about the font's 
character cells. 

fm_fontdir(3W) Set the direction for writing characters. 

fm_getname(3W) Return the path name of the font's definition file. 

fm_load(3W) Load a font file into memory and activate it. 

fm_opt(3W) Optimize character generation if possible. 

fm_rasterinfo(3W) This routine returns size information (i.e., pixel width, height, and 
baseline) about the font's character cells. 

fm_remove(3W) Remove a font from n\emory. Once a font is removed from 

memory, it must be reloaded, via fm_load{3W), before it can be 
used again. 

fm_str_len(3W) Return the pixel length of a character string. The length is deter- 

mined from the font size of the active font. 

fm_styleinfo(3W) Return style information about a font. This information is 

returned in an escapecodes structure, as defined in 
/usr/include/fonticon.h. 

fm_write(3W) Use the active font to display characters. 

EXAMPLES 

The following example compiles a program, named fontmprog.c , that calls font manager routines 
to display text in graphics windows. The program will run on a Series 300 low-resolution 
display using retained windows (thus the -ldd300I and -Iddbyte options). 
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cc fontmprog.c -Ifontm -IddSOOl -Iddbyte — Iwindow -Isbl — lsb2 

SEE ALSO 

windows(l),fa(3W),gopen(3G),wmdow(3W). 
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Fast Alpha/Font Manager Reference 

Manual entries are arranged alphabetically by entry name. Section number follows the entry name and 
is enclosed within parentheses. 

Description Entry Name(Section) 

activate a fast alpha font FAFONTACTlVATE(3W) 

activate a font FM_ACTIVATE(3W) 

activation, load a font into the user's font cache and prepare it for FAFONTLOAD(3W) 

bit flag, set sixteen FM_SIXTEEN_BIT(3W) 

cells in a font, return size of FM_RASTERlNFO(3W) 

cells in font file, return size of FM_FILEINFO(3W) 

character direction, set FM_FONTDlR(3W) 

character, fill area of window with specified FARECTWRITE(3W) 

character generation, optimize if possible FM_OPT(3W) 

character string, determine pixel length of FM_STR_LEN(3W) 

characters to the screen, write FM_WRITE(3W) 

characters with their enhancements, write a line of FAWRITE(3W) 

clear the window area specified by the given rectangle FACLEAR(3W) 

clip limits, set FM_CLIPLIM(3W) 

clipping flag, set FM_CLIPFLAG(3W) 

colors, set active font's foreground and background FM_COLORS(3W) 

colors, set fast alpha font foreground and background FACOLORS(3W) 

cursor, control the displayed FACURSOR(3W) 

direction, set character FM_FONTDlR(3W) 

displayed cursor, control FACURSOR(3W) 

environment, get information about the fast alpha FAGETlNFO(3W) 

environment, set information about fast alpha FASETlNFO(3W) 

environment, terminate the current fast alpha FATERMINATE(3W) 

fa - summary of fast alpha library routines FA(3W) 

faclear — clear the window area specified by the given rectangle FACLEAR(3W) 

facolors - set the fast alpha font foreground and background colors FACOLORS(3W) 

facursor - control the displayed cursor FACURSOR(3W) 

fafontactivate - activate a fast alpha font fafontactivate(3W) 

fafontload - load a font into the user's font cache and prepare it for activation FAFONTLOAD(3W) 

fafontremove - remove a font from the user's font cache fafontremove(3W) 

fagetinfo - get information about the fast alpha environment FAGETlNFO(3W) 

fainit — prepare a fast alpha window device for output, and set up all defaults FAINIT(3W) 

farectwrite - fill area of window with specified character FARECTWRITE(3W) 

faroll — roll a portion of the window FAR0LL(3W) 

fasetinfo - set information about the fast alpha environment FASETlNFO(3W) 

fast alpha environment, get information about FAGETlNFO(3W) 

fast alpha environment, set information about FASETlNFO(3W) 

fast alpha environment, terminate the current FATERMINATE(3W) 

fast alpha font, activate FAF0NTACTIVATE(3W) 

fast alpha font foreground and background colors, set FACOLORS(3W) 

fast alpha library routines, summary of FA(3W) 

fast alpha window device, prepare for output, and set up all defaults FAINIT(3W) 

faterminate — terminate the current fast alpha environment FATERMINATE(3W) 

fawrite — write a line of characters with their enhancements FAWRITE(3W) 

filename, translate font id to FM_GETNAME(3W) 

fill area of window with specified character FARECTWRITE(3W) 

flag, set clipping fm_clipflag(3W) 

flag, set sixteen bit fm_sixteen_bit(3W) 

fm_activate - make a font active FM_ACTIVATE(3W) 

fm_clipflag - set clipping flag fm_clipflaG(3W) 

fm_cliplim - set clip limits FM_CLIPLIM(3W) 

fm_colors — set active font's foreground and background colors FM_COLORS(3W) 
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Fast Alpha/Font Manager Programming Reference 

Description Entry Name(Section) 

fm_fileinfo - return size of cells in font file fm_fileinfo(3W) 

fm_fontdir - set character direction fm_fontdir(3W) 

fm_getname - translate font id to filename fm_getname(3W) 

fmjoad — load a font into memory fm_load(3W) 

fm_opt - optimize character generation if possible FM_OPT(3W) 

fm_rasterinfo - return the size of cells in a font fm_rasterinfo(3W) 

fm_remove - remove a font fm_remove(3W) 

fm_sixteen_bit - set sixteen bit flag fm_sixteen_bit(3W) 

fm_str_len - determine the pixel length of a character string fm_str_len(3W) 

fm_styleinfo — return style information about a font fm_STYLEINFO(3W) 

fmjarite - write characters to the screen fm_write(3W) 

font, activate a fast alpha fafontactivate(3W) 

font, activate fm_activate(3W) 

font, fast alpha, set foreground and background colors facolors(3W) 

font file, return size of cells in FM,FILElNFO(3W) 

font from the user's font cache, remove FAFONTREMOVE(3W) 

font id to filename, translate fm_getname(3W) 

font into memory, load FM_LOAD(3W) 

font, load into the user's font cache and prepare it for activation FAFONTLOAD(3W) 

font manager library routines, summary of F0NTM(3W) 

font, remove FM_REMOVE(3W) 

font, return size of cells in FM_RASTERINF0(3W) 

font, return style information about FM_STYLElNFO(3W) 

jontm - summary of font manager library routines FONTM(3W) 

font's foreground and background colors, set active FM_COLORS(3W) 

get information about the fast alpha environment FAGETINF0(3W) 

id to filename, translate font FM_GETNAME(3W) 

information about a font, return style FM_STYLElNFO(3W) 

information about the fast alpha environment, get FAGETlNFO(3W) 

information about the fast alpha environment, set FASETlNFO(3W) 

length of a character string, determine pixel FM_STR_LEN(3W) 

library routines, summary of fast alpha FA(3W) 

library routines, summary of font manager FONTM(3W) 

limits, set clip FM_CUPLIM(3W) 

load a font into memory FM_LOAD(3W) 

load a font into the user's font cache and prepare it for activation FAFONTLOAD(3W) 

memory, load a font into FM_LOAD(3W) 

optimize character generation if possible FM_OPT(3W) 

output, prepare a fast alpha window device for, and set up all defaults FAINIT(3W) 

pixel length of a character string, determine FM_STR_LEN(3W) 

rectangle, clear the window area specified by the given faclear(3W) 

remove a font from the user's font cache fafontremove(3W) 

remove a font FM_REMOVE(3W) 

roll a portion of the window FAROLL(3W) 

routines, summary of fast alpha library FA(3W) 

routines, summary of font manager library FONTM(3W) 

screen, write characters to fm_write(3W) 

set information about the fast alpha environment FASETINF0(3W) 

sixteen bit flag, set FM_SIXTEEN_BIT(3W) 

size of cells in a font, return FM_RASTERlNFO(3W) 
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Description Entry Name(Section) 

size of cells in font file, return FM_FILElNFO(3W) 

string, determine pixel length of character FM_STR_LEN(3W) 

style information about a font, return FM_STYLElNFO(3W) 

summary of fast alpha library routines FA(3W) 

summary of font manager library routines FONTM(3W) 

terminate the current fast alpha environment FATERMINATE(3W) 

translate font id to filename FM_GETNAME(3W) 

window area specified by the given rectangle, clear FACLEAR(3W) 

window, fill area of, with specified character FARECTWRITE(3W) 

window, roll a portion of FAROLL(3W) 

write a line of characters with their enhancements FAWRITE(3W) 

write characters to the screen FM_WRITE(3W) 
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Getting Font Information 

A program is provided with the Fast Alpha/Font Managers libraries that will 
enable you to extract information concerning the raster fonts. The following 
steps will allow you to compile and execute the f ontinf o program. The resultant 
display will give you font information. 

1. Log in as superuser. 

2. Type cd to /usr/lib/f a_fm_demo 

3. Type make -f Makefile f ontinf o 

4. Type f ontinfo /usr/lib/raster/(/onit directory) / {font name) 
(See table A-1 for font directories and names.) 

For example: 

f ontinf o /usr/lib/raster/8xl6/lp . 8u 

When you execute f ontinf o on a Hewlett-Packard raster font, a summary of 
font information is printed to the standard output. 
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Raster Fonts 

This is a list of the fonts provided with the Fast Alpha/Font Manager libraries. 
For each font size, the corresponding HP-UX directory path is shown. 

Table A-1. Font Directories and Names 



Font Directory 


Font Name 


Description 


/usr/lib/raster/ 10x20 


kana.8K 

lp.8U 

lp.b.8U 


Katakana, 8 bit 
Romans, ascii, 8 bit 
Romans, ascii, 8 bit (bold) 


/usr/lib/raster/12x20 


cour.O 
Ucour . b . OU 


Courier style, ascii, 8 bit 
Courier style, ascii, 8 bit (bold) 


/usr/lib/raster/ 12x24 


kana.SK 
kan j i . 16K 


Katakana (Japanese), 8 bit 
Kanji (Japanese), 16 bit 


/usr/lib/raster/18x30 


math.OM 
pica.SU 


Greek letters, 8 bit 
Pica style, ascii, 8 bit 


/usr/lib/raster/5xl8 


kana.SK 
kanji.l6K 


Katakana (Japanese), 8 bit 
Kanji (Japanese), 16 bit 


/usr/ lib/rast er /6x24 


kana.SK 
kan j i . 16K 


Katakana (Japanese), 8 bit 
Kanji (Japanese), 16 bit 


/usr/lib/raster/6x8 


Ip.SU 

Ip.b.SI 

math.SM 


Romans, ascii, 8 bit 
Romans, ascii, 8 bit (bold) 
Greek letters, 8 bit 


/usr/lib/raster/7xl0 


ip.su 


Romans, ascii, 8 bit 


/usr/lib/raster/8xl6 


kana . 8K 

linedraw.OL 

Ip.SU 

Ip.b.SU 

Ip.i.SU 

math.OM 


Katakana (Japanese), 8 bit 
Line drawing characters, 8 bit 
Romans, ascii, 8 bit 
Romans, ascii, 8 bit (bold) 
Romans, ascii, 8 bit (itahc) 
Greek letters, 8 bit 
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Table A-1. Font Directories and Names 
Continued 



Font Directory 


Font Name 


Description 


/usr/lib/raster/8xl8 


kana.SK 
kan j i . 16K 


Katakana (Japanese), 8 bit 
Kanji (Japanese), 16 bit 


/usr/lib/raster/8x20 


kana.SK 
kanji.l6K 


Katakana (Japanese), 8 bit 
Kanji (Japanese), 16 bit 


/usr/lib/raster/L6xl5 


Ip.SU 


Romans, ascii, 8 bit 



Supported Fonts in Windows 

The following table summarizes the font libraries, font characters, and font 
file formats supported in the different window systems. Raw mode and 
HP Windows/9000 are grouped together because the font capabihties are identi- 
cal. 
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Table A-2. Font Libraries, Font Character Sets and Font Formats 



Window System 


Supported 
Font Library 


Supported Fonts 


Font File Format 


Pre-3.1/6.5 
Raw Mode and 
Windows/9000 


FA/FM Library 


8-Bit: FA/FM fonts; 
HP- 15: FA/FM fonts 


FA/FM format 


XIO 


XIO font 
procedures 


8-Bit: XIO fonts; 
HP-15: HP XIO Kanji 


XIO format 


XI 1 revision A.OO 


Xll font 
procedures 


8-bit: Xll fonts; 
16-bit: Xll Kanji; 
HP-15: HP Xll Kanji 


Server Natural 
Format (SNF), 
BDF 


Xll 


Xll Xlib font 
procedures, 
FA/FM Library 


8-bit: Xll fonts, 
FA/FM fonts; 
16-bit: Xll Kanji; 
HP-15: HP Xll Kanji 


SNF, BDF 


3.1/6.5 Raw Mode 


FA/FM Library 


8-bit: Xll fonts, 
FA/FM fonts; 
HP-15: HP Xll Kanji 


SNF, BDF 


3.1/6.5 

HP Windows/9000 


FA/FM Library 


8-bit: FA/FM fonts; 
HP-15: HP Xll Kanji 


SNF, BDF 
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Note Only the XI 1 font procedures can be used in an XI 1 revision 

A. 00 window. Both the XI 1 font procedures and the FA/FM font 
procedures can be used in an XI 1 (post-revision A. 00) window. 

In 3.1/6.5 raw mode, the FA/FM Hbrary can access either 
the FA/FM fonts or the XI 1 fonts. However, in 3.1/6.5 
HP Windows/9000, only the FA/FM and HP-15 fonts can be 
used. 



Windows Effect on FA/FM 

Changes to Text Operation 

The 6.5 (Series 300) and 3.1 (Series 800) releases of HP-UX effect FA/FM text 
operation in several ways. 

■ The FA/FM libraries can be used in an XI 1 window. Prior to the 3.1 
(Series 800) and 6.5 (Series 300) HP-UX releases, these libraries were 
only usable in raw mode and with HP Windows/9000 (Series 300 only). 
As with raw mode or HP Windows/9000 operation, the file descriptor 
returned by the Starbase open of the XI 1 window is used by the FA/FM 
routines. 

■ The FA/FM libraries and the XI 1 raster font procedures now share a 
common font file format. This format is based on the XI 1 format, not on 
the FA/FM font file format. This permits any FA/FM font or XI 1 font 
to be used by either the FA/FM libraries or the XI 1 font hbrary. 

Specific Changes to Fonts 

The 3.1/6.5 FA/FM font loader (which loads fonts from disc into virtual memory) 
has been modified to only load SNF fonts, not fonts in the pre-3. 1/6.5 FA/FM font 
format. Therefore, the FA/FM fonts have been converted to SNF and provided 
with the 3.1/6.5 HP-UX releases. Note the following points: 

■ The font file format, and not the FA/FM library functionality, has been 
changed. Access to XI 1 fonts by the FA/FM libraries is only supported 
in raw mode. HP Windows/9000 does not support use of Xll fonts. 
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■ The pre-3. 1/6.5 FA/FM font files cannotbe loaded by a later FA/FM font 
loader. To support pre-3. 1/6.5 executables which reference FA/FM fonts, 
the FA/FM font files are shipped with the 3.1/6.5 releases of HP-UX. 

■ When you compile a pre-3. 1/6.5 FA/FM program (which references the 
pre-3. 1/6.5 FA/FM font files by name), link the program with the later 
FA/FM libraries (which only know how to load SNF fonts), the following 
support is provided to avoid changing the font file names in your source 
code: 

When the referenced FA/FM font file is not an SNF font, the FA/FM 
font loader looks for a related SNF font in an associated subdirectory. 
For example, if your pre-3. 1/6.5 program accesses the FA/FM font 
/usr/lib/raster/8xl6/lp.8U, this font cannot be loaded by the 3.1/6.5 
FA/FM font loader because it is not an SNF font. Therefore, the font 
loader looks for the SNF font /usr/lib/raster/8xl6/SNF/lp.8U.scf 
and loads it. 

SNF versus non-SNF Fonts 

The following diagram shows several examples of how the FA/FM SNF and non- 
SNF fonts are related: 

FA/FM fonts: /usr/lib/raster/8x16/ 



pre-3. 1/6. 5 / >. 3.1/6.5 

FA/FM fonts in FA/FM format / \ FA/FM fonts in SNF 




lp.8U SNF/lp.8U.scf 

moth.OM SNF/math.OM.scf 

Figure A-1 . FA/FM Fonts in FA/FM Format and in SNF 
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Which Font To Use 

The following table summarizes what font is used based on the nature of your 
program: 

Table A-3. FA/FM Font File Usage 



Application 


Font File Used 


Example Font File 


Pre-3. 1/6.5 executable 


Pre-3.1/6.5 FA/FM 

fonts in FA/FM 
format 


usr/lib/raster/8xl6/lp . 8U 


Pre-3.1/6.5 source which 
references pre-3.1/6.5 
FA/FM fonts but is linked 
with later libraries 


FA/FM font files in 

SNF 


usr/lib/raster/8xl6/SNF/ 

lp.8U.snf 
(do not break line) 


FA/FM program which 
references 3.1/6.5 FA/FM 
fonts 


FA/FM font files in 

SNF 


usr/lib/raster/8xl6/SNF/ 

lp.8U.snf 
(do not break line) 
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fm_getname 3-21 

FM_leiigth.c example 3-13 

f m_load 3-4 

fin_opt 3-12 

fm_rasterinfo 3-18 

f m_remove 3-5 

fm_str_len 3-12 

f m_str_len, relation to clipping 3-12, 3-14 

FM_Struct . c example 3-6 

fm_write 3-7, 3-9 

font, activating fast alpha 2-19 

font, baseline height 3-17 

font cache, font manager 3-3 

font cell 3-17 

font color, font manager 3-4 

font colors, setting for fast alpha 2-19 

font directories 4-3 

font file 3-3 

font files 4-2 

font height 3-17 

font id, fast alpha 2-18 

font id, font manager 3-3 

font management, fast alpha 2-18 

font management, font manager model 3-3 

font manager, activating a font 3-5 

font manager, active font 3-3 

font manager, clipping 3-14 

font manager, color 3-7 

font manager, direction of write 3-9 

font manager, disabling clipping 3-14 

font manager, enabling clipping 3-14 

font manager font cache 3-3 

font manager, font color 3-4 

font manager, font id 3-3 

font manager font table 3-3 

font manager, getting font size information 3-18 

Font Manager Library 3-1 

Font Manager Library concepts 3-2 

Font Manager Library, linking with programs 4-2 

font manager, loading fonts 3-3 



lndex-5 



font manager, obtaining information about fonts 3-17 

font manager, optimizing writes 3-12 

font manager, removing a font 3-5 

font manager, removing fonts 3-4 

font manager, setting clip limits 3-15 

font manager, string length 3-12 

font manager, write direction control 3-9 

font manager, writing characters 3-7 

Font Manager/Fast Alpha differences 3-1 

font name, getting with font manager 3-21 

font size 3-17 

font size, getting with font manager 3-18 

font style 3-17, 3-20 

font style, getting font manager information 3-20 

font table, font manager 3-3 

font width 3-17 

f ontcellheight, of the fast alpha f ainf o structure 2-8, 2-10 

f ontcellwidth, of the fast alpha f ainf o structure 2-8, 2-10 

fonticon.h header file 3-2, 4-3 

Fonts.c program 2-20 

Font_size.c, example 3-19 

f oregroundplanes, of the fast alpha f ainf o structure 2-8, 2-10 

G 

gclose(3G) when using fast alpha routines 2-3 

getting a font's name with font manager 3-21 

getting fast alpha environment information 2-8 

getting font manager style information 3-20 

getting font size information, font manager 3-18 

gopen(3G), relation to Font Manager Library 3-2 

gopen(3G) when using fast alpha routine 2-2 

graphics window type, displaying text using Fast Alpha 2-1 

H 

header files 

fa.h2-2, 4-3 

fonticon.h 3-2, 4-3 
height of font 3-17 
hpitch, of font manager escapecodes structure 3-20 



lndex-6 



I 

icon definition files 4-3 

icon files 4-2 

initializing the fast alpha environment 2-6 

initializing the fast alpha environment, example 2-7 



LANG 4-3 

libdddriver . a 4-2 

libfa.a4-2 

libfontm.a 4-2 

libraries, linking with window programs 4-1 

libsbl.a4-2 

libsb2.a4-2 

libwindow.a 4-2 

link order when compiling window programs 4-2 

linking libraries 2-6, 4-2 

linking libraries with window programs 4-1 

loading fast alpha fonts 2-18 

loading font manager fonts 3-4 

loading fonts, font manager 3-3 

M 

make cur rent, of fast alpha f ainf o structure 2-8, 2-11 
makecurrent, of the fast alpha f ainf o structure 2-8, 2-10 
MCALWAYS 2-11 



optimization of character generation 3-7 
optimizing font manager writes 3-12 



program 

Cursor. c 2-14 

Fainfo 2-12 

Fonts.c 2-20 

Structure 2-7 
program Clear.c 2-22 
program FM_clipping.c 3-15 
program FM_Colors.c 3-11 
program FM_Direction.c 3-10 



lndex-7 



program FM_length.c 3-13 

program FM_Struct . c 3-6 

program Font_size.c 3-19 

program Style.c 3-21 

proportional, of font manager escapecodes structure 3-20 

protocol, fast alpha 2-2 

Q 

quality, of font manager escapecodes structure 3-20 



rectangles, fast alpha 2-4 
removing a font manager font 3-5 
removing fast alpha fonts 2-18 
removing font manager fonts 3-4 



scrolling a fast alpha rectangle 2-23 

setting fast alpha environment information 2-8 

setting fast alpha font colors 2-19 

setting font manager clip limits 3-15 

shared memory, font manager 3-4 

size, font 3-17 

size, of fast alpha f ainf o structure 2-8, 2-10 

Starbase Library, linking with programs 4-2 

string length, font manager 3-12 

Structure program 2-7 

style, font 3-17, 3-20 

Style.c example 3-21 

symbol_int, of font manager escapecodes structure 3-20 



terminating the fast alpha environment 2-6 

terminating the fast alpha environment, example 2-7 

text in a graphics window, using Fast Alpha 2-1 

text, writing in graphics windows using Font Manager Library 3-1 

typeface, of font manager escapecodes structure 3-20 

U 

/usr/include/fa.h 2-2, 4-3 
/usr/include/fonticon.h 3-2, 4-3 

lndex-8 



/usr/lib/libdddriver.a 4-2 
/usr/lib/libfa.a4-2 
/usr/lib/libfontm.a 4-2 
/usr/lib/libsbl.a4-2 
/usr/lib/libsb2.a4-2 
/usr/lib/libwindow.a 4-2 
/usr/lib/raster/* 4-3 
/usr/lib/raster/dflt/a/h/$LANG 4-3 
/usr/lib/raster/dflt/a/l/$LANG 4-3 
/usr/lib/raster/dflt/b/h/$LANG 4-3 
/usr/lib/raster/dflt/b/l/$LANG 4-3 
/usr/lib/raster/icons 4-3 

V 

vheight, of font manager escapecodes structure 3-20 

W 

width of font 3-17 

Window Library, linking with programs 4-2 

WMBASEFONT 2-18 

WMFONTDIR 3-3 

writing characters with font manager 3-7 

writing fast alpha character strings 2-15 

writing fast alpha characters 2-15 

writing font manager characters 3-7 



lndex-9 



i>d 



HEWLETT 
PACKARD 



HP Part Number 
98592-90092 

Microfiche No. 98592-99092 
Printed in U.S.A. E0989 




For Internal Use Only 



